diff --git a/.github/DISCUSSION_TEMPLATE/questions.yml b/.github/DISCUSSION_TEMPLATE/questions.yml
index 3726b7d18..98424a341 100644
--- a/.github/DISCUSSION_TEMPLATE/questions.yml
+++ b/.github/DISCUSSION_TEMPLATE/questions.yml
@@ -123,6 +123,20 @@ body:
         ```
     validations:
       required: true
+  - type: input
+    id: pydantic-version
+    attributes:
+      label: Pydantic Version
+      description: |
+        What Pydantic version are you using?
+
+        You can find the Pydantic version with:
+
+        ```bash
+        python -c "import pydantic; print(pydantic.version.VERSION)"
+        ```
+    validations:
+      required: true
   - type: input
     id: python-version
     attributes:
diff --git a/.github/actions/comment-docs-preview-in-pr/Dockerfile b/.github/actions/comment-docs-preview-in-pr/Dockerfile
index 4f20c5f10..14b0d0269 100644
--- a/.github/actions/comment-docs-preview-in-pr/Dockerfile
+++ b/.github/actions/comment-docs-preview-in-pr/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.7
+FROM python:3.9
 
 RUN pip install httpx "pydantic==1.5.1" pygithub
 
diff --git a/.github/actions/notify-translations/Dockerfile b/.github/actions/notify-translations/Dockerfile
index fa4197e6a..b68b4bb1a 100644
--- a/.github/actions/notify-translations/Dockerfile
+++ b/.github/actions/notify-translations/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.7
+FROM python:3.9
 
 RUN pip install httpx PyGithub "pydantic==1.5.1" "pyyaml>=5.3.1,<6.0.0"
 
diff --git a/.github/actions/notify-translations/app/main.py b/.github/actions/notify-translations/app/main.py
index 494fe6ad8..8ac1f233d 100644
--- a/.github/actions/notify-translations/app/main.py
+++ b/.github/actions/notify-translations/app/main.py
@@ -9,7 +9,7 @@ import httpx
 from github import Github
 from pydantic import BaseModel, BaseSettings, SecretStr
 
-awaiting_label = "awaiting review"
+awaiting_label = "awaiting-review"
 lang_all_label = "lang-all"
 approved_label = "approved-2"
 translations_path = Path(__file__).parent / "translations.yml"
diff --git a/.github/actions/people/Dockerfile b/.github/actions/people/Dockerfile
index fa4197e6a..1455106bd 100644
--- a/.github/actions/people/Dockerfile
+++ b/.github/actions/people/Dockerfile
@@ -1,6 +1,6 @@
-FROM python:3.7
+FROM python:3.9
 
-RUN pip install httpx PyGithub "pydantic==1.5.1" "pyyaml>=5.3.1,<6.0.0"
+RUN pip install httpx PyGithub "pydantic==2.0.2" pydantic-settings "pyyaml>=5.3.1,<6.0.0"
 
 COPY ./app /app
 
diff --git a/.github/actions/people/app/main.py b/.github/actions/people/app/main.py
index b11e3456d..cb6b229e8 100644
--- a/.github/actions/people/app/main.py
+++ b/.github/actions/people/app/main.py
@@ -9,7 +9,8 @@ from typing import Any, Container, DefaultDict, Dict, List, Set, Union
 import httpx
 import yaml
 from github import Github
-from pydantic import BaseModel, BaseSettings, SecretStr
+from pydantic import BaseModel, SecretStr
+from pydantic_settings import BaseSettings
 
 github_graphql_url = "https://api.github.com/graphql"
 questions_category_id = "MDE4OkRpc2N1c3Npb25DYXRlZ29yeTMyMDAxNDM0"
@@ -382,6 +383,7 @@ def get_graphql_response(
     data = response.json()
     if "errors" in data:
         logging.error(f"Errors in response, after: {after}, category_id: {category_id}")
+        logging.error(data["errors"])
         logging.error(response.text)
         raise RuntimeError(response.text)
     return data
@@ -389,7 +391,7 @@ def get_graphql_response(
 
 def get_graphql_issue_edges(*, settings: Settings, after: Union[str, None] = None):
     data = get_graphql_response(settings=settings, query=issues_query, after=after)
-    graphql_response = IssuesResponse.parse_obj(data)
+    graphql_response = IssuesResponse.model_validate(data)
     return graphql_response.data.repository.issues.edges
 
 
@@ -404,19 +406,19 @@ def get_graphql_question_discussion_edges(
         after=after,
         category_id=questions_category_id,
     )
-    graphql_response = DiscussionsResponse.parse_obj(data)
+    graphql_response = DiscussionsResponse.model_validate(data)
     return graphql_response.data.repository.discussions.edges
 
 
 def get_graphql_pr_edges(*, settings: Settings, after: Union[str, None] = None):
     data = get_graphql_response(settings=settings, query=prs_query, after=after)
-    graphql_response = PRsResponse.parse_obj(data)
+    graphql_response = PRsResponse.model_validate(data)
     return graphql_response.data.repository.pullRequests.edges
 
 
 def get_graphql_sponsor_edges(*, settings: Settings, after: Union[str, None] = None):
     data = get_graphql_response(settings=settings, query=sponsors_query, after=after)
-    graphql_response = SponsorsResponse.parse_obj(data)
+    graphql_response = SponsorsResponse.model_validate(data)
     return graphql_response.data.user.sponsorshipsAsMaintainer.edges
 
 
@@ -607,7 +609,7 @@ def get_top_users(
 if __name__ == "__main__":
     logging.basicConfig(level=logging.INFO)
     settings = Settings()
-    logging.info(f"Using config: {settings.json()}")
+    logging.info(f"Using config: {settings.model_dump_json()}")
     g = Github(settings.input_token.get_secret_value())
     repo = g.get_repo(settings.github_repository)
     question_commentors, question_last_month_commentors, question_authors = get_experts(
diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index 19009447b..701c74697 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -17,7 +17,7 @@ jobs:
     outputs:
       docs: ${{ steps.filter.outputs.docs }}
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     # For pull requests it's not necessary to checkout the code but for master it is
     - uses: dorny/paths-filter@v2
       id: filter
@@ -35,7 +35,7 @@ jobs:
     outputs:
       langs: ${{ steps.show-langs.outputs.langs }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -44,14 +44,17 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v05
+          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt', 'requirements-docs-tests.txt') }}-v06
       - name: Install docs extras
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       # Install MkDocs Material Insiders here just to put it in the cache for the rest of the steps
       - name: Install Material for MkDocs Insiders
-        if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+        if: ( github.event_name != 'pull_request' || github.secret_source == 'Actions' ) && steps.cache.outputs.cache-hit != 'true'
+        run: |
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/mkdocstrings-python.git
       - name: Export Language Codes
         id: show-langs
         run: |
@@ -71,7 +74,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -80,13 +83,16 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v05
+          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt', 'requirements-docs-tests.txt') }}-v06
       - name: Install docs extras
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       - name: Install Material for MkDocs Insiders
-        if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+        if: ( github.event_name != 'pull_request' || github.secret_source != 'Actions' ) && steps.cache.outputs.cache-hit != 'true'
+        run: |
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/mkdocstrings-python.git
       - name: Update Languages
         run: python ./scripts/docs.py update-languages
       - uses: actions/cache@v3
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 312d835af..155ebd0a8 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -14,14 +14,14 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Clean site
         run: |
           rm -rf ./site
           mkdir ./site
       - name: Download Artifact Docs
         id: download
-        uses: dawidd6/action-download-artifact@v2.27.0
+        uses: dawidd6/action-download-artifact@v2.28.0
         with:
           if_no_artifact_found: ignore
           github_token: ${{ secrets.FASTAPI_PREVIEW_DOCS_DOWNLOAD_ARTIFACTS }}
@@ -29,21 +29,20 @@ jobs:
           run_id: ${{ github.event.workflow_run.id }}
           name: docs-site
           path: ./site/
-      - name: Deploy to Netlify
+      - name: Deploy to Cloudflare Pages
         if: steps.download.outputs.found_artifact == 'true'
-        id: netlify
-        uses: nwtgck/actions-netlify@v2.0.0
+        id: deploy
+        uses: cloudflare/pages-action@v1
         with:
-          publish-dir: './site'
-          production-deploy: ${{ github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' }}
-          github-token: ${{ secrets.FASTAPI_PREVIEW_DOCS_NETLIFY }}
-          enable-commit-comment: false
-        env:
-          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
-          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          projectName: fastapitiangolo
+          directory: './site'
+          gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+          branch: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
       - name: Comment Deploy
-        if: steps.netlify.outputs.deploy-url != ''
+        if: steps.deploy.outputs.url != ''
         uses: ./.github/actions/comment-docs-preview-in-pr
         with:
           token: ${{ secrets.FASTAPI_PREVIEW_DOCS_COMMENT_DEPLOY }}
-          deploy_url: "${{ steps.netlify.outputs.deploy-url }}"
+          deploy_url: "${{ steps.deploy.outputs.url }}"
diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index 324623103..bb967fa11 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -19,6 +19,10 @@ jobs:
     if: github.repository_owner == 'tiangolo'
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: tiangolo/issue-manager@0.4.0
         with:
           token: ${{ secrets.FASTAPI_ISSUE_MANAGER }}
diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml
index 976d29f74..2113c468a 100644
--- a/.github/workflows/label-approved.yml
+++ b/.github/workflows/label-approved.yml
@@ -9,6 +9,10 @@ jobs:
     if: github.repository_owner == 'tiangolo'
     runs-on: ubuntu-latest
     steps:
+    - name: Dump GitHub context
+      env:
+        GITHUB_CONTEXT: ${{ toJson(github) }}
+      run: echo "$GITHUB_CONTEXT"
     - uses: docker://tiangolo/label-approved:0.0.2
       with:
         token: ${{ secrets.FASTAPI_LABEL_APPROVED }}
diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index 1f7ac7b28..b9b550d5e 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -14,25 +14,32 @@ on:
       debug_enabled:
         description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
         required: false
-        default: false
+        default: 'false'
 
 jobs:
   latest-changes:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - uses: actions/checkout@v4
         with:
-          # To allow latest-changes to commit to master
+          # To allow latest-changes to commit to the main branch
           token: ${{ secrets.FASTAPI_LATEST_CHANGES }}
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled }}
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
-      - uses: docker://tiangolo/latest-changes:0.0.3
+      - uses: docker://tiangolo/latest-changes:0.2.0
+      # - uses: tiangolo/latest-changes@main
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           latest_changes_file: docs/en/docs/release-notes.md
-          latest_changes_header: '## Latest Changes\n\n'
+          latest_changes_header: '## Latest Changes'
+          end_regex: '^## '
           debug_logs: true
+          label_header_prefix: '### '
diff --git a/.github/workflows/notify-translations.yml b/.github/workflows/notify-translations.yml
index 0926486e9..c0904ce48 100644
--- a/.github/workflows/notify-translations.yml
+++ b/.github/workflows/notify-translations.yml
@@ -5,16 +5,29 @@ on:
     types:
       - labeled
       - closed
+  workflow_dispatch:
+    inputs:
+      number:
+        description: PR number
+        required: true
+      debug_enabled:
+        description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
+        required: false
+        default: 'false'
 
 jobs:
   notify-translations:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - uses: actions/checkout@v4
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled }}
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
       - uses: ./.github/actions/notify-translations
diff --git a/.github/workflows/people.yml b/.github/workflows/people.yml
index dac526a6c..b0868771d 100644
--- a/.github/workflows/people.yml
+++ b/.github/workflows/people.yml
@@ -8,21 +8,25 @@ on:
       debug_enabled:
         description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
         required: false
-        default: false
+        default: 'false'
 
 jobs:
   fastapi-people:
     if: github.repository_owner == 'tiangolo'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - uses: actions/checkout@v4
       # Ref: https://github.com/actions/runner/issues/2033
       - name: Fix git safe.directory in container
         run: mkdir -p /home/runner/work/_temp/_github_home && printf "[safe]\n\tdirectory = /github/workspace" > /home/runner/work/_temp/_github_home/.gitconfig
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled }}
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
       - uses: ./.github/actions/people
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index b84c5bf17..8cbd01b92 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -13,11 +13,11 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.7"
+          python-version: "3.10"
           # Issue ref: https://github.com/actions/setup-python/issues/436
           # cache: "pip"
           cache-dependency-path: pyproject.toml
@@ -32,7 +32,7 @@ jobs:
       - name: Build distribution
         run: python -m build
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.8.6
+        uses: pypa/gh-action-pypi-publish@v1.8.10
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}
       - name: Dump GitHub context
diff --git a/.github/workflows/smokeshow.yml b/.github/workflows/smokeshow.yml
index c6d894d9f..38b44c413 100644
--- a/.github/workflows/smokeshow.yml
+++ b/.github/workflows/smokeshow.yml
@@ -14,13 +14,17 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/setup-python@v4
         with:
           python-version: '3.9'
 
       - run: pip install smokeshow
 
-      - uses: dawidd6/action-download-artifact@v2.27.0
+      - uses: dawidd6/action-download-artifact@v2.28.0
         with:
           github_token: ${{ secrets.FASTAPI_SMOKESHOW_DOWNLOAD_ARTIFACTS }}
           workflow: test.yml
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index b95358d01..59754525d 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -13,7 +13,11 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -25,7 +29,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v03
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v06
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -38,11 +42,15 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.8", "3.9", "3.10", "3.11"]
         pydantic-version: ["pydantic-v1", "pydantic-v2"]
       fail-fast: false
     steps:
-      - uses: actions/checkout@v3
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -54,7 +62,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v03
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v06
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -80,7 +88,11 @@ jobs:
     needs: [test]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
+      - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
         with:
           python-version: '3.8'
@@ -110,6 +122,10 @@ jobs:
       - coverage-combine
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - name: Decide whether the needed jobs succeeded or failed
         uses: re-actors/alls-green@release/v1
         with:
diff --git a/.gitignore b/.gitignore
index d380d16b7..9be494cec 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,3 +25,6 @@ archive.zip
 *~
 .*.sw?
 .cache
+
+# macOS
+.DS_Store
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 9f7085f72..a7f2fb3f2 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -13,23 +13,13 @@ repos:
         -   --unsafe
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
--   repo: https://github.com/asottile/pyupgrade
-    rev: v3.7.0
-    hooks:
-    -   id: pyupgrade
-        args:
-        - --py3-plus
-        - --keep-runtime-typing
 -   repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.0.275
+    rev: v0.1.2
     hooks:
     -   id: ruff
         args:
         - --fix
--   repo: https://github.com/psf/black
-    rev: 23.3.0
-    hooks:
-    -   id: black
+    -   id: ruff-format
 ci:
     autofix_commit_msg: 🎨 [pre-commit.ci] Auto format from pre-commit.com hooks
     autoupdate_commit_msg: ⬆ [pre-commit.ci] pre-commit autoupdate
diff --git a/CITATION.cff b/CITATION.cff
new file mode 100644
index 000000000..9028248b1
--- /dev/null
+++ b/CITATION.cff
@@ -0,0 +1,24 @@
+# This CITATION.cff file was generated with cffinit.
+# Visit https://bit.ly/cffinit to generate yours today!
+
+cff-version: 1.2.0
+title: FastAPI
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - given-names: Sebastián
+    family-names: Ramírez
+    email: tiangolo@gmail.com
+identifiers:
+repository-code: 'https://github.com/tiangolo/fastapi'
+url: 'https://fastapi.tiangolo.com'
+abstract: >-
+  FastAPI framework, high performance, easy to learn, fast to code,
+  ready for production
+keywords:
+  - fastapi
+  - pydantic
+  - starlette
+license: MIT
diff --git a/README.md b/README.md
index 36c71081e..aeb29b587 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.7+ based on standard Python type hints.
+FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints.
 
 The key features are:
 
@@ -48,13 +48,17 @@ The key features are:
 
 <a href="https://cryptapi.io/" target="_blank" title="CryptAPI: Your easy to use, secure and privacy oriented payment gateway."><img src="https://fastapi.tiangolo.com/img/sponsors/cryptapi.svg"></a>
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
+<a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
+<a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
+<a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
 <a href="https://github.com/deepset-ai/haystack/" target="_blank" title="Build powerful search from composable, open source building blocks"><img src="https://fastapi.tiangolo.com/img/sponsors/haystack-fastapi.svg"></a>
 <a href="https://careers.powens.com/" target="_blank" title="Powens is hiring!"><img src="https://fastapi.tiangolo.com/img/sponsors/powens.png"></a>
-<a href="https://www.svix.com/" target="_blank" title="Svix - Webhooks as a service"><img src="https://fastapi.tiangolo.com/img/sponsors/svix.svg"></a>
 <a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
+<a href="https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship" target="_blank" title="SDKs for your API | Speakeasy"><img src="https://fastapi.tiangolo.com/img/sponsors/speakeasy.png"></a>
+<a href="https://www.svix.com/" target="_blank" title="Svix - Webhooks as a service"><img src="https://fastapi.tiangolo.com/img/sponsors/svix.svg"></a>
 
 <!-- /sponsors -->
 
@@ -116,7 +120,7 @@ If you are building a <abbr title="Command Line Interface">CLI</abbr> app to be
 
 ## Requirements
 
-Python 3.7+
+Python 3.8+
 
 FastAPI stands on the shoulders of giants:
 
@@ -332,7 +336,7 @@ You do that with standard modern Python types.
 
 You don't have to learn a new syntax, the methods or classes of a specific library, etc.
 
-Just standard **Python 3.7+**.
+Just standard **Python 3.8+**.
 
 For example, for an `int`:
 
diff --git a/docs/de/docs/features.md b/docs/de/docs/features.md
index f281afd1e..64fa8092d 100644
--- a/docs/de/docs/features.md
+++ b/docs/de/docs/features.md
@@ -25,7 +25,7 @@ Mit einer interaktiven API-Dokumentation und explorativen webbasierten Benutzers
 
 ### Nur modernes Python
 
-Alles basiert auf **Python 3.6 Typ**-Deklarationen (dank Pydantic). Es muss keine neue Syntax gelernt werden, nur standardisiertes modernes Python.
+Alles basiert auf **Python 3.8 Typ**-Deklarationen (dank Pydantic). Es muss keine neue Syntax gelernt werden, nur standardisiertes modernes Python.
 
 
 
diff --git a/docs/em/docs/advanced/extending-openapi.md b/docs/em/docs/advanced/extending-openapi.md
deleted file mode 100644
index 496a8d9de..000000000
--- a/docs/em/docs/advanced/extending-openapi.md
+++ /dev/null
@@ -1,314 +0,0 @@
-# ↔ 🗄
-
-!!! warning
-    👉 👍 🏧 ⚒. 👆 🎲 💪 🚶 ⚫️.
-
-    🚥 👆 📄 🔰 - 👩‍💻 🦮, 👆 💪 🎲 🚶 👉 📄.
-
-    🚥 👆 ⏪ 💭 👈 👆 💪 🔀 🏗 🗄 🔗, 😣 👂.
-
-📤 💼 🌐❔ 👆 💪 💪 🔀 🏗 🗄 🔗.
-
-👉 📄 👆 🔜 👀 ❔.
-
-## 😐 🛠️
-
-😐 (🔢) 🛠️, ⏩.
-
-`FastAPI` 🈸 (👐) ✔️ `.openapi()` 👩‍🔬 👈 📈 📨 🗄 🔗.
-
-🍕 🈸 🎚 🏗, *➡ 🛠️* `/openapi.json` (⚖️ ⚫️❔ 👆 ⚒ 👆 `openapi_url`) ®.
-
-⚫️ 📨 🎻 📨 ⏮️ 🏁 🈸 `.openapi()` 👩‍🔬.
-
-🔢, ⚫️❔ 👩‍🔬 `.openapi()` 🔨 ✅ 🏠 `.openapi_schema` 👀 🚥 ⚫️ ✔️ 🎚 &amp; 📨 👫.
-
-🚥 ⚫️ 🚫, ⚫️ 🏗 👫 ⚙️ 🚙 🔢 `fastapi.openapi.utils.get_openapi`.
-
-&amp; 👈 🔢 `get_openapi()` 📨 🔢:
-
-* `title`: 🗄 📛, 🎦 🩺.
-* `version`: ⏬ 👆 🛠️, ✅ `2.5.0`.
-* `openapi_version`: ⏬ 🗄 🔧 ⚙️. 🔢, ⏪: `3.0.2`.
-* `description`: 📛 👆 🛠️.
-* `routes`: 📇 🛣, 👫 🔠 ® *➡ 🛠️*. 👫 ✊ ⚪️➡️ `app.routes`.
-
-## 🔑 🔢
-
-⚙️ ℹ 🔛, 👆 💪 ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗 &amp; 🔐 🔠 🍕 👈 👆 💪.
-
-🖼, ➡️ 🚮 <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">📄 🗄 ↔ 🔌 🛃 🔱</a>.
-
-### 😐 **FastAPI**
-
-🥇, ✍ 🌐 👆 **FastAPI** 🈸 🛎:
-
-```Python hl_lines="1  4  7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 🏗 🗄 🔗
-
-⤴️, ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗, 🔘 `custom_openapi()` 🔢:
-
-```Python hl_lines="2  15-20"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 🔀 🗄 🔗
-
-🔜 👆 💪 🚮 📄 ↔, ❎ 🛃 `x-logo` `info` "🎚" 🗄 🔗:
-
-```Python hl_lines="21-23"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 💾 🗄 🔗
-
-👆 💪 ⚙️ 🏠 `.openapi_schema` "💾", 🏪 👆 🏗 🔗.
-
-👈 🌌, 👆 🈸 🏆 🚫 ✔️ 🏗 🔗 🔠 🕰 👩‍💻 📂 👆 🛠️ 🩺.
-
-⚫️ 🔜 🏗 🕴 🕐, &amp; ⤴️ 🎏 💾 🔗 🔜 ⚙️ ⏭ 📨.
-
-```Python hl_lines="13-14  24-25"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 🔐 👩‍🔬
-
-🔜 👆 💪 ❎ `.openapi()` 👩‍🔬 ⏮️ 👆 🆕 🔢.
-
-```Python hl_lines="28"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### ✅ ⚫️
-
-🕐 👆 🚶 <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> 👆 🔜 👀 👈 👆 ⚙️ 👆 🛃 🔱 (👉 🖼, **FastAPI**'Ⓜ 🔱):
-
-<img src="/img/tutorial/extending-openapi/image01.png">
-
-## 👤-🕸 🕸 &amp; 🎚 🩺
-
-🛠️ 🩺 ⚙️ **🦁 🎚** &amp; **📄**, &amp; 🔠 👈 💪 🕸 &amp; 🎚 📁.
-
-🔢, 👈 📁 🍦 ⚪️➡️ <abbr title="Content Delivery Network: A service, normally composed of several servers, that provides static files, like JavaScript and CSS. It's commonly used to serve those files from the server closer to the client, improving performance.">💲</abbr>.
-
-✋️ ⚫️ 💪 🛃 ⚫️, 👆 💪 ⚒ 🎯 💲, ⚖️ 🍦 📁 👆.
-
-👈 ⚠, 🖼, 🚥 👆 💪 👆 📱 🚧 👷 ⏪ 📱, 🍵 📂 🕸 🔐, ⚖️ 🇧🇿 🕸.
-
-📥 👆 🔜 👀 ❔ 🍦 👈 📁 👆, 🎏 FastAPI 📱, &amp; 🔗 🩺 ⚙️ 👫.
-
-### 🏗 📁 📊
-
-➡️ 💬 👆 🏗 📁 📊 👀 💖 👉:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-```
-
-🔜 ✍ 📁 🏪 📚 🎻 📁.
-
-👆 🆕 📁 📊 💪 👀 💖 👉:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static/
-```
-
-### ⏬ 📁
-
-⏬ 🎻 📁 💪 🩺 &amp; 🚮 👫 🔛 👈 `static/` 📁.
-
-👆 💪 🎲 ▶️️-🖊 🔠 🔗 &amp; 🖊 🎛 🎏 `Save link as...`.
-
-**🦁 🎚** ⚙️ 📁:
-
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@4/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@4/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
-
-&amp; **📄** ⚙️ 📁:
-
-* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
-
-⏮️ 👈, 👆 📁 📊 💪 👀 💖:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static
-    ├── redoc.standalone.js
-    ├── swagger-ui-bundle.js
-    └── swagger-ui.css
-```
-
-### 🍦 🎻 📁
-
-* 🗄 `StaticFiles`.
-* "🗻" `StaticFiles()` 👐 🎯 ➡.
-
-```Python hl_lines="7  11"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### 💯 🎻 📁
-
-▶️ 👆 🈸 &amp; 🚶 <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
-
-👆 🔜 👀 📶 📏 🕸 📁 **📄**.
-
-⚫️ 💪 ▶️ ⏮️ 🕳 💖:
-
-```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- *   Version: "2.0.0-rc.18"
- *   Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
-...
-```
-
-👈 ✔ 👈 👆 💆‍♂ 💪 🍦 🎻 📁 ⚪️➡️ 👆 📱, &amp; 👈 👆 🥉 🎻 📁 🩺 ☑ 🥉.
-
-🔜 👥 💪 🔗 📱 ⚙️ 📚 🎻 📁 🩺.
-
-### ❎ 🏧 🩺
-
-🥇 🔁 ❎ 🏧 🩺, 📚 ⚙️ 💲 🔢.
-
-❎ 👫, ⚒ 👫 📛 `None` 🕐❔ 🏗 👆 `FastAPI` 📱:
-
-```Python hl_lines="9"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### 🔌 🛃 🩺
-
-🔜 👆 💪 ✍ *➡ 🛠️* 🛃 🩺.
-
-👆 💪 🏤-⚙️ FastAPI 🔗 🔢 ✍ 🕸 📃 🩺, &amp; 🚶‍♀️ 👫 💪 ❌:
-
-* `openapi_url`: 📛 🌐❔ 🕸 📃 🩺 💪 🤚 🗄 🔗 👆 🛠️. 👆 💪 ⚙️ 📥 🔢 `app.openapi_url`.
-* `title`: 📛 👆 🛠️.
-* `oauth2_redirect_url`: 👆 💪 ⚙️ `app.swagger_ui_oauth2_redirect_url` 📥 ⚙️ 🔢.
-* `swagger_js_url`: 📛 🌐❔ 🕸 👆 🦁 🎚 🩺 💪 🤚 **🕸** 📁. 👉 1️⃣ 👈 👆 👍 📱 🔜 🍦.
-* `swagger_css_url`: 📛 🌐❔ 🕸 👆 🦁 🎚 🩺 💪 🤚 **🎚** 📁. 👉 1️⃣ 👈 👆 👍 📱 🔜 🍦.
-
-&amp; ➡ 📄...
-
-```Python hl_lines="2-6  14-22  25-27  30-36"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-!!! tip
-     *➡ 🛠️* `swagger_ui_redirect` 👩‍🎓 🕐❔ 👆 ⚙️ Oauth2️⃣.
-
-    🚥 👆 🛠️ 👆 🛠️ ⏮️ Oauth2️⃣ 🐕‍🦺, 👆 🔜 💪 🔓 &amp; 👟 🔙 🛠️ 🩺 ⏮️ 📎 🎓. &amp; 🔗 ⏮️ ⚫️ ⚙️ 🎰 Oauth2️⃣ 🤝.
-
-    🦁 🎚 🔜 🍵 ⚫️ ⛅ 🎑 👆, ✋️ ⚫️ 💪 👉 "❎" 👩‍🎓.
-
-### ✍ *➡ 🛠️* 💯 ⚫️
-
-🔜, 💪 💯 👈 🌐 👷, ✍ *➡ 🛠️*:
-
-```Python hl_lines="39-41"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### 💯 ⚫️
-
-🔜, 👆 🔜 💪 🔌 👆 📻, 🚶 👆 🩺 <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, &amp; 🔃 📃.
-
-&amp; 🍵 🕸, 👆 🔜 💪 👀 🩺 👆 🛠️ &amp; 🔗 ⏮️ ⚫️.
-
-## 🛠️ 🦁 🎚
-
-👆 💪 🔗 ➕ <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">🦁 🎚 🔢</a>.
-
-🔗 👫, 🚶‍♀️ `swagger_ui_parameters` ❌ 🕐❔ 🏗 `FastAPI()` 📱 🎚 ⚖️ `get_swagger_ui_html()` 🔢.
-
-`swagger_ui_parameters` 📨 📖 ⏮️ 📳 🚶‍♀️ 🦁 🎚 🔗.
-
-FastAPI 🗜 📳 **🎻** ⚒ 👫 🔗 ⏮️ 🕸, 👈 ⚫️❔ 🦁 🎚 💪.
-
-### ❎ ❕ 🎦
-
-🖼, 👆 💪 ❎ ❕ 🎦 🦁 🎚.
-
-🍵 🔀 ⚒, ❕ 🎦 🛠️ 🔢:
-
-<img src="/img/tutorial/extending-openapi/image02.png">
-
-✋️ 👆 💪 ❎ ⚫️ ⚒ `syntaxHighlight` `False`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial003.py!}
-```
-
-...&amp; ⤴️ 🦁 🎚 🏆 🚫 🎦 ❕ 🎦 🚫🔜:
-
-<img src="/img/tutorial/extending-openapi/image03.png">
-
-### 🔀 🎢
-
-🎏 🌌 👆 💪 ⚒ ❕ 🎦 🎢 ⏮️ 🔑 `"syntaxHighlight.theme"` (👀 👈 ⚫️ ✔️ ❣ 🖕):
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial004.py!}
-```
-
-👈 📳 🔜 🔀 ❕ 🎦 🎨 🎢:
-
-<img src="/img/tutorial/extending-openapi/image04.png">
-
-### 🔀 🔢 🦁 🎚 🔢
-
-FastAPI 🔌 🔢 📳 🔢 ☑ 🌅 ⚙️ 💼.
-
-⚫️ 🔌 👫 🔢 📳:
-
-```Python
-{!../../../fastapi/openapi/docs.py[ln:7-13]!}
-```
-
-👆 💪 🔐 🙆 👫 ⚒ 🎏 💲 ❌ `swagger_ui_parameters`.
-
-🖼, ❎ `deepLinking` 👆 💪 🚶‍♀️ 👉 ⚒ `swagger_ui_parameters`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial005.py!}
-```
-
-### 🎏 🦁 🎚 🔢
-
-👀 🌐 🎏 💪 📳 👆 💪 ⚙️, ✍ 🛂 <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">🩺 🦁 🎚 🔢</a>.
-
-### 🕸-🕴 ⚒
-
-🦁 🎚 ✔ 🎏 📳 **🕸-🕴** 🎚 (🖼, 🕸 🔢).
-
-FastAPI 🔌 👫 🕸-🕴 `presets` ⚒:
-
-```JavaScript
-presets: [
-    SwaggerUIBundle.presets.apis,
-    SwaggerUIBundle.SwaggerUIStandalonePreset
-]
-```
-
-👫 **🕸** 🎚, 🚫 🎻, 👆 💪 🚫 🚶‍♀️ 👫 ⚪️➡️ 🐍 📟 🔗.
-
-🚥 👆 💪 ⚙️ 🕸-🕴 📳 💖 📚, 👆 💪 ⚙️ 1️⃣ 👩‍🔬 🔛. 🔐 🌐 🦁 🎚 *➡ 🛠️* &amp; ❎ ✍ 🙆 🕸 👆 💪.
diff --git a/docs/em/docs/advanced/settings.md b/docs/em/docs/advanced/settings.md
index bc50bf755..2ebe8ffcb 100644
--- a/docs/em/docs/advanced/settings.md
+++ b/docs/em/docs/advanced/settings.md
@@ -221,7 +221,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
 ```
 
 !!! tip
-    👥 🔜 🔬 `@lru_cache()` 🍖.
+    👥 🔜 🔬 `@lru_cache` 🍖.
 
     🔜 👆 💪 🤔 `get_settings()` 😐 🔢.
 
@@ -254,7 +254,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
 
     ✋️ 🇨🇻 📁 🚫 🤙 ✔️ ✔️ 👈 ☑ 📁.
 
-Pydantic ✔️ 🐕‍🦺 👂 ⚪️➡️ 👉 🆎 📁 ⚙️ 🔢 🗃. 👆 💪 ✍ 🌖 <a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic ⚒: 🇨🇻 (.🇨🇻) 🐕‍🦺</a>.
+Pydantic ✔️ 🐕‍🦺 👂 ⚪️➡️ 👉 🆎 📁 ⚙️ 🔢 🗃. 👆 💪 ✍ 🌖 <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic ⚒: 🇨🇻 (.🇨🇻) 🐕‍🦺</a>.
 
 !!! tip
     👉 👷, 👆 💪 `pip install python-dotenv`.
@@ -302,7 +302,7 @@ def get_settings():
 
 👥 🔜 ✍ 👈 🎚 🔠 📨, &amp; 👥 🔜 👂 `.env` 📁 🔠 📨. 👶 👶
 
-✋️ 👥 ⚙️ `@lru_cache()` 👨‍🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶
+✋️ 👥 ⚙️ `@lru_cache` 👨‍🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶
 
 ```Python hl_lines="1  10"
 {!../../../docs_src/settings/app03/main.py!}
@@ -312,14 +312,14 @@ def get_settings():
 
 #### `lru_cache` 📡 ℹ
 
-`@lru_cache()` 🔀 🔢 ⚫️ 🎀 📨 🎏 💲 👈 📨 🥇 🕰, ↩️ 💻 ⚫️ 🔄, 🛠️ 📟 🔢 🔠 🕰.
+`@lru_cache` 🔀 🔢 ⚫️ 🎀 📨 🎏 💲 👈 📨 🥇 🕰, ↩️ 💻 ⚫️ 🔄, 🛠️ 📟 🔢 🔠 🕰.
 
 , 🔢 🔛 ⚫️ 🔜 🛠️ 🕐 🔠 🌀 ❌. &amp; ⤴️ 💲 📨 🔠 👈 🌀 ❌ 🔜 ⚙️ 🔄 &amp; 🔄 🕐❔ 🔢 🤙 ⏮️ ⚫️❔ 🎏 🌀 ❌.
 
 🖼, 🚥 👆 ✔️ 🔢:
 
 ```Python
-@lru_cache()
+@lru_cache
 def say_hi(name: str, salutation: str = "Ms."):
     return f"Hello {salutation} {name}"
 ```
@@ -371,7 +371,7 @@ participant execute as Execute function
 
 👈 🌌, ⚫️ 🎭 🌖 🚥 ⚫️ 🌐 🔢. ✋️ ⚫️ ⚙️ 🔗 🔢, ⤴️ 👥 💪 🔐 ⚫️ 💪 🔬.
 
-`@lru_cache()` 🍕 `functools` ❔ 🍕 🐍 🐩 🗃, 👆 💪 ✍ 🌅 🔃 ⚫️ <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">🐍 🩺 `@lru_cache()`</a>.
+`@lru_cache` 🍕 `functools` ❔ 🍕 🐍 🐩 🗃, 👆 💪 ✍ 🌅 🔃 ⚫️ <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">🐍 🩺 `@lru_cache`</a>.
 
 ## 🌃
 
@@ -379,4 +379,4 @@ participant execute as Execute function
 
 * ⚙️ 🔗 👆 💪 📉 🔬.
 * 👆 💪 ⚙️ `.env` 📁 ⏮️ ⚫️.
-* ⚙️ `@lru_cache()` ➡️ 👆 ❎ 👂 🇨🇻 📁 🔄 &amp; 🔄 🔠 📨, ⏪ 🤝 👆 🔐 ⚫️ ⏮️ 🔬.
+* ⚙️ `@lru_cache` ➡️ 👆 ❎ 👂 🇨🇻 📁 🔄 &amp; 🔄 🔠 📨, ⏪ 🤝 👆 🔐 ⚫️ ⏮️ 🔬.
diff --git a/docs/em/docs/async.md b/docs/em/docs/async.md
index 13b362b5d..ddcae1573 100644
--- a/docs/em/docs/async.md
+++ b/docs/em/docs/async.md
@@ -409,11 +409,11 @@ async def read_burgers():
 
 ### 🔗
 
-🎏 ✔ [🔗](/tutorial/dependencies/index.md){.internal-link target=_blank}. 🚥 🔗 🐩 `def` 🔢 ↩️ `async def`, ⚫️ 🏃 🔢 🧵.
+🎏 ✔ [🔗](./tutorial/dependencies/index.md){.internal-link target=_blank}. 🚥 🔗 🐩 `def` 🔢 ↩️ `async def`, ⚫️ 🏃 🔢 🧵.
 
 ### 🎧-🔗
 
-👆 💪 ✔️ 💗 🔗 &amp; [🎧-🔗](/tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} 🚫 🔠 🎏 (🔢 🔢 🔑), 👫 💪 ✍ ⏮️ `async def` &amp; ⏮️ 😐 `def`. ⚫️ 🔜 👷, &amp; 🕐 ✍ ⏮️ 😐 `def` 🔜 🤙 🔛 🔢 🧵 (⚪️➡️ 🧵) ↩️ ➖ "⌛".
+👆 💪 ✔️ 💗 🔗 &amp; [🎧-🔗](./tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} 🚫 🔠 🎏 (🔢 🔢 🔑), 👫 💪 ✍ ⏮️ `async def` &amp; ⏮️ 😐 `def`. ⚫️ 🔜 👷, &amp; 🕐 ✍ ⏮️ 😐 `def` 🔜 🤙 🔛 🔢 🧵 (⚪️➡️ 🧵) ↩️ ➖ "⌛".
 
 ### 🎏 🚙 🔢
 
diff --git a/docs/em/docs/deployment/concepts.md b/docs/em/docs/deployment/concepts.md
index 8ce775411..162b68615 100644
--- a/docs/em/docs/deployment/concepts.md
+++ b/docs/em/docs/deployment/concepts.md
@@ -43,7 +43,7 @@
     * ⏮️ 🔢 🦲 💖 Certbot 📄 🔕
 * ✳
     * ⏮️ 🔢 🦲 💖 Certbot 📄 🔕
-* Kubernete ⏮️ 🚧 🕹 💖 👌
+* Kubernetes ⏮️ 🚧 🕹 💖 👌
     * ⏮️ 🔢 🦲 💖 🛂-👨‍💼 📄 🔕
 * 🍵 🔘 ☁ 🐕‍🦺 🍕 👫 🐕‍🦺 (✍ 🔛 👶)
 
@@ -115,7 +115,7 @@
 🖼 🧰 👈 💪 👉 👨‍🏭:
 
 * ☁
-* Kubernete
+* Kubernetes
 * ☁ ✍
 * ☁ 🐝 📳
 * ✳
@@ -165,7 +165,7 @@
 🖼, 👉 💪 🍵:
 
 * ☁
-* Kubernete
+* Kubernetes
 * ☁ ✍
 * ☁ 🐝 📳
 * ✳
@@ -233,15 +233,15 @@
     * 🐁 🔜 **🛠️ 👨‍💼** 👂 🔛 **📢** &amp; **⛴**, 🧬 🔜 ✔️ **💗 Uvicorn 👨‍🏭 🛠️**
 * **Uvicorn** 🛠️ **Uvicorn 👨‍🏭**
     * 1️⃣ Uvicorn **🛠️ 👨‍💼** 🔜 👂 🔛 **📢** &amp; **⛴**, &amp; ⚫️ 🔜 ▶️ **💗 Uvicorn 👨‍🏭 🛠️**
-* **Kubernete** &amp; 🎏 📎 **📦 ⚙️**
+* **Kubernetes** &amp; 🎏 📎 **📦 ⚙️**
     * 🕳 **☁** 🧽 🔜 👂 🔛 **📢** &amp; **⛴**. 🧬 🔜 ✔️ **💗 📦**, 🔠 ⏮️ **1️⃣ Uvicorn 🛠️** 🏃‍♂
 * **☁ 🐕‍🦺** 👈 🍵 👉 👆
     * ☁ 🐕‍🦺 🔜 🎲 **🍵 🧬 👆**. ⚫️ 🔜 🎲 ➡️ 👆 🔬 **🛠️ 🏃**, ⚖️ **📦 🖼** ⚙️, 🙆 💼, ⚫️ 🔜 🌅 🎲 **👁 Uvicorn 🛠️**, &amp; ☁ 🐕‍🦺 🔜 🈚 🔁 ⚫️.
 
 !!! tip
-    🚫 😟 🚥 👫 🏬 🔃 **📦**, ☁, ⚖️ Kubernete 🚫 ⚒ 📚 🔑.
+    🚫 😟 🚥 👫 🏬 🔃 **📦**, ☁, ⚖️ Kubernetes 🚫 ⚒ 📚 🔑.
 
-    👤 🔜 💬 👆 🌅 🔃 📦 🖼, ☁, Kubernete, ♒️. 🔮 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
+    👤 🔜 💬 👆 🌅 🔃 📦 🖼, ☁, Kubernetes, ♒️. 🔮 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
 
 ## ⏮️ 🔁 ⏭ ▶️
 
@@ -268,7 +268,7 @@
 
 📥 💪 💭:
 
-*  "🕑 📦" Kubernete 👈 🏃 ⏭ 👆 📱 📦
+*  "🕑 📦" Kubernetes 👈 🏃 ⏭ 👆 📱 📦
 * 🎉 ✍ 👈 🏃 ⏮️ 🔁 &amp; ⤴️ ▶️ 👆 🈸
     * 👆 🔜 💪 🌌 ▶️/⏏ *👈* 🎉 ✍, 🔍 ❌, ♒️.
 
diff --git a/docs/em/docs/deployment/deta.md b/docs/em/docs/deployment/deta.md
deleted file mode 100644
index 89b6c4bdb..000000000
--- a/docs/em/docs/deployment/deta.md
+++ /dev/null
@@ -1,258 +0,0 @@
-# 🛠️ FastAPI 🔛 🪔
-
-👉 📄 👆 🔜 💡 ❔ 💪 🛠️ **FastAPI** 🈸 🔛 <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🪔</a> ⚙️ 🆓 📄. 👶
-
-⚫️ 🔜 ✊ 👆 🔃 **1️⃣0️⃣ ⏲**.
-
-!!! info
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🪔</a> **FastAPI** 💰. 👶
-
-## 🔰 **FastAPI** 📱
-
-* ✍ 📁 👆 📱, 🖼, `./fastapideta/` &amp; ⛔ 🔘 ⚫️.
-
-### FastAPI 📟
-
-* ✍ `main.py` 📁 ⏮️:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### 📄
-
-🔜, 🎏 📁 ✍ 📁 `requirements.txt` ⏮️:
-
-```text
-fastapi
-```
-
-!!! tip
-    👆 🚫 💪 ❎ Uvicorn 🛠️ 🔛 🪔, 👐 👆 🔜 🎲 💚 ❎ ⚫️ 🌐 💯 👆 📱.
-
-### 📁 📊
-
-👆 🔜 🔜 ✔️ 1️⃣ 📁 `./fastapideta/` ⏮️ 2️⃣ 📁:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## ✍ 🆓 🪔 🏧
-
-🔜 ✍ <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🆓 🏧 🔛 🪔</a>, 👆 💪 📧 &amp; 🔐.
-
-👆 🚫 💪 💳.
-
-## ❎ ✳
-
-🕐 👆 ✔️ 👆 🏧, ❎ 🪔 <abbr title="Command Line Interface application">✳</abbr>:
-
-=== "💾, 🇸🇻"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "🚪 📋"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-⏮️ ❎ ⚫️, 📂 🆕 📶 👈 ❎ ✳ 🔍.
-
-🆕 📶, ✔ 👈 ⚫️ ☑ ❎ ⏮️:
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip
-    🚥 👆 ✔️ ⚠ ❎ ✳, ✅ <a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">🛂 🪔 🩺</a>.
-
-## 💳 ⏮️ ✳
-
-🔜 💳 🪔 ⚪️➡️ ✳ ⏮️:
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-👉 🔜 📂 🕸 🖥 &amp; 🔓 🔁.
-
-## 🛠️ ⏮️ 🪔
-
-⏭, 🛠️ 👆 🈸 ⏮️ 🪔 ✳:
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-👆 🔜 👀 🎻 📧 🎏:
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip
-    👆 🛠️ 🔜 ✔️ 🎏 `"endpoint"` 📛.
-
-## ✅ ⚫️
-
-🔜 📂 👆 🖥 👆 `endpoint` 📛. 🖼 🔛 ⚫️ `https://qltnci.deta.dev`, ✋️ 👆 🔜 🎏.
-
-👆 🔜 👀 🎻 📨 ⚪️➡️ 👆 FastAPI 📱:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-&amp; 🔜 🚶 `/docs` 👆 🛠️, 🖼 🔛 ⚫️ 🔜 `https://qltnci.deta.dev/docs`.
-
-⚫️ 🔜 🎦 👆 🩺 💖:
-
-<img src="/img/deployment/deta/image01.png">
-
-## 🛠️ 📢 🔐
-
-🔢, 🪔 🔜 🍵 🤝 ⚙️ 🍪 👆 🏧.
-
-✋️ 🕐 👆 🔜, 👆 💪 ⚒ ⚫️ 📢 ⏮️:
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-🔜 👆 💪 💰 👈 📛 ⏮️ 🙆 &amp; 👫 🔜 💪 🔐 👆 🛠️. 👶
-
-## 🇺🇸🔍
-
-㊗ ❗ 👆 🛠️ 👆 FastAPI 📱 🪔 ❗ 👶 👶
-
-, 👀 👈 🪔 ☑ 🍵 🇺🇸🔍 👆, 👆 🚫 ✔️ ✊ 💅 👈 &amp; 💪 💭 👈 👆 👩‍💻 🔜 ✔️ 🔐 🗜 🔗. 👶 👶
-
-## ✅ 🕶
-
-⚪️➡️ 👆 🩺 🎚 (👫 🔜 📛 💖 `https://qltnci.deta.dev/docs`) 📨 📨 👆 *➡ 🛠️* `/items/{item_id}`.
-
-🖼 ⏮️ 🆔 `5`.
-
-🔜 🚶 <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.
-
-👆 🔜 👀 📤 📄 ◀️ 🤙 <abbr title="it comes from Micro(server)">"◾"</abbr> ⏮️ 🔠 👆 📱.
-
-👆 🔜 👀 📑 ⏮️ "ℹ", &amp; 📑 "🕶", 🚶 📑 "🕶".
-
-📤 👆 💪 ✔ ⏮️ 📨 📨 👆 📱.
-
-👆 💪 ✍ 👫 &amp; 🏤-🤾 👫.
-
-<img src="/img/deployment/deta/image02.png">
-
-## 💡 🌅
-
-☝, 👆 🔜 🎲 💚 🏪 💽 👆 📱 🌌 👈 😣 🔘 🕰. 👈 👆 💪 ⚙️ <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">🪔 🧢</a>, ⚫️ ✔️ 👍 **🆓 🎚**.
-
-👆 💪 ✍ 🌅 <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">🪔 🩺</a>.
-
-## 🛠️ 🔧
-
-👟 🔙 🔧 👥 🔬 [🛠️ 🔧](./concepts.md){.internal-link target=_blank}, 📥 ❔ 🔠 👫 🔜 🍵 ⏮️ 🪔:
-
-* **🇺🇸🔍**: 🍵 🪔, 👫 🔜 🤝 👆 📁 &amp; 🍵 🇺🇸🔍 🔁.
-* **🏃‍♂ 🔛 🕴**: 🍵 🪔, 🍕 👫 🐕‍🦺.
-* **⏏**: 🍵 🪔, 🍕 👫 🐕‍🦺.
-* **🧬**: 🍵 🪔, 🍕 👫 🐕‍🦺.
-* **💾**: 📉 🔁 🪔, 👆 💪 📧 👫 📈 ⚫️.
-* **⏮️ 🔁 ⏭ ▶️**: 🚫 🔗 🐕‍🦺, 👆 💪 ⚒ ⚫️ 👷 ⏮️ 👫 💾 ⚙️ ⚖️ 🌖 ✍.
-
-!!! note
-    🪔 🔧 ⚒ ⚫️ ⏩ (&amp; 🆓) 🛠️ 🙅 🈸 🔜.
-
-    ⚫️ 💪 📉 📚 ⚙️ 💼, ✋️ 🎏 🕰, ⚫️ 🚫 🐕‍🦺 🎏, 💖 ⚙️ 🔢 💽 (↖️ ⚪️➡️ 🪔 👍 ☁ 💽 ⚙️), 🛃 🕹 🎰, ♒️.
-
-    👆 💪 ✍ 🌅 ℹ <a href="https://docs.deta.sh/docs/micros/about/" class="external-link" target="_blank">🪔 🩺</a> 👀 🚥 ⚫️ ▶️️ ⚒ 👆.
diff --git a/docs/em/docs/deployment/docker.md b/docs/em/docs/deployment/docker.md
index 51ece5599..f28735ed7 100644
--- a/docs/em/docs/deployment/docker.md
+++ b/docs/em/docs/deployment/docker.md
@@ -74,7 +74,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
 , 👆 🔜 🏃 **💗 📦** ⏮️ 🎏 👜, 💖 💽, 🐍 🈸, 🕸 💽 ⏮️ 😥 🕸 🈸, &amp; 🔗 👫 👯‍♂️ 📨 👫 🔗 🕸.
 
-🌐 📦 🧾 ⚙️ (💖 ☁ ⚖️ Kubernete) ✔️ 👫 🕸 ⚒ 🛠️ 🔘 👫.
+🌐 📦 🧾 ⚙️ (💖 ☁ ⚖️ Kubernetes) ✔️ 👫 🕸 ⚒ 🛠️ 🔘 👫.
 
 ## 📦 &amp; 🛠️
 
@@ -96,7 +96,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
 👉 ⚫️❔ 👆 🔜 💚 **🏆 💼**, 🖼:
 
-* ⚙️ **Kubernete** ⚖️ 🎏 🧰
+* ⚙️ **Kubernetes** ⚖️ 🎏 🧰
 * 🕐❔ 🏃‍♂ 🔛 **🍓 👲**
 * ⚙️ ☁ 🐕‍🦺 👈 🔜 🏃 📦 🖼 👆, ♒️.
 
@@ -395,7 +395,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 ⚫️ 💪 ➕1️⃣ 📦, 🖼 ⏮️ <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>, 🚚 **🇺🇸🔍** &amp; **🏧** 🛠️ **📄**.
 
 !!! tip
-    Traefik ✔️ 🛠️ ⏮️ ☁, Kubernete, &amp; 🎏, ⚫️ 📶 ⏩ ⚒ 🆙 &amp; 🔗 🇺🇸🔍 👆 📦 ⏮️ ⚫️.
+    Traefik ✔️ 🛠️ ⏮️ ☁, Kubernetes, &amp; 🎏, ⚫️ 📶 ⏩ ⚒ 🆙 &amp; 🔗 🇺🇸🔍 👆 📦 ⏮️ ⚫️.
 
 👐, 🇺🇸🔍 💪 🍵 ☁ 🐕‍🦺 1️⃣ 👫 🐕‍🦺 (⏪ 🏃 🈸 📦).
 
@@ -403,7 +403,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 📤 🛎 ➕1️⃣ 🧰 🈚 **▶️ &amp; 🏃‍♂** 👆 📦.
 
-⚫️ 💪 **☁** 🔗, **☁ ✍**, **Kubernete**, **☁ 🐕‍🦺**, ♒️.
+⚫️ 💪 **☁** 🔗, **☁ ✍**, **Kubernetes**, **☁ 🐕‍🦺**, ♒️.
 
 🌅 (⚖️ 🌐) 💼, 📤 🙅 🎛 🛠️ 🏃 📦 🔛 🕴 &amp; 🛠️ ⏏ 🔛 ❌. 🖼, ☁, ⚫️ 📋 ⏸ 🎛 `--restart`.
 
@@ -413,7 +413,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 🚥 👆 ✔️ <abbr title="A group of machines that are configured to be connected and work together in some way.">🌑</abbr> 🎰 ⏮️ **☁**, ☁ 🐝 📳, 🖖, ⚖️ ➕1️⃣ 🎏 🏗 ⚙️ 🛠️ 📎 📦 🔛 💗 🎰, ⤴️ 👆 🔜 🎲 💚 **🍵 🧬** **🌑 🎚** ↩️ ⚙️ **🛠️ 👨‍💼** (💖 🐁 ⏮️ 👨‍🏭) 🔠 📦.
 
-1️⃣ 📚 📎 📦 🧾 ⚙️ 💖 Kubernete 🛎 ✔️ 🛠️ 🌌 🚚 **🧬 📦** ⏪ 🔗 **📐 ⚖** 📨 📨. 🌐 **🌑 🎚**.
+1️⃣ 📚 📎 📦 🧾 ⚙️ 💖 Kubernetes 🛎 ✔️ 🛠️ 🌌 🚚 **🧬 📦** ⏪ 🔗 **📐 ⚖** 📨 📨. 🌐 **🌑 🎚**.
 
 📚 💼, 👆 🔜 🎲 💚 🏗 **☁ 🖼 ⚪️➡️ 🖌** [🔬 🔛](#dockerfile), ❎ 👆 🔗, &amp; 🏃‍♂ **👁 Uvicorn 🛠️** ↩️ 🏃‍♂ 🕳 💖 🐁 ⏮️ Uvicorn 👨‍🏭.
 
@@ -430,7 +430,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 ### 1️⃣ 📐 ⚙ - 💗 👨‍🏭 📦
 
-🕐❔ 👷 ⏮️ **Kubernete** ⚖️ 🎏 📎 📦 🧾 ⚙️, ⚙️ 👫 🔗 🕸 🛠️ 🔜 ✔ 👁 **📐 ⚙** 👈 👂 🔛 👑 **⛴** 📶 📻 (📨) 🎲 **💗 📦** 🏃 👆 📱.
+🕐❔ 👷 ⏮️ **Kubernetes** ⚖️ 🎏 📎 📦 🧾 ⚙️, ⚙️ 👫 🔗 🕸 🛠️ 🔜 ✔ 👁 **📐 ⚙** 👈 👂 🔛 👑 **⛴** 📶 📻 (📨) 🎲 **💗 📦** 🏃 👆 📱.
 
 🔠 👫 📦 🏃‍♂ 👆 📱 🔜 🛎 ✔️ **1️⃣ 🛠️** (✅ Uvicorn 🛠️ 🏃 👆 FastAPI 🈸). 👫 🔜 🌐 **🌓 📦**, 🏃‍♂ 🎏 👜, ✋️ 🔠 ⏮️ 🚮 👍 🛠️, 💾, ♒️. 👈 🌌 👆 🔜 ✊ 📈 **🛠️** **🎏 🐚** 💽, ⚖️ **🎏 🎰**.
 
@@ -489,7 +489,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 🚥 👆 🏃 **👁 🛠️ 📍 📦** 👆 🔜 ✔️ 🌅 ⚖️ 🌘 👍-🔬, ⚖, &amp; 📉 💸 💾 🍴 🔠 👈 📦 (🌅 🌘 1️⃣ 🚥 👫 🔁).
 
-&amp; ⤴️ 👆 💪 ⚒ 👈 🎏 💾 📉 &amp; 📄 👆 📳 👆 📦 🧾 ⚙️ (🖼 **Kubernete**). 👈 🌌 ⚫️ 🔜 💪 **🔁 📦** **💪 🎰** ✊ 🔘 🏧 💸 💾 💪 👫, &amp; 💸 💪 🎰 🌑.
+&amp; ⤴️ 👆 💪 ⚒ 👈 🎏 💾 📉 &amp; 📄 👆 📳 👆 📦 🧾 ⚙️ (🖼 **Kubernetes**). 👈 🌌 ⚫️ 🔜 💪 **🔁 📦** **💪 🎰** ✊ 🔘 🏧 💸 💾 💪 👫, &amp; 💸 💪 🎰 🌑.
 
 🚥 👆 🈸 **🙅**, 👉 🔜 🎲 **🚫 ⚠**, &amp; 👆 💪 🚫 💪 ✔ 🏋️ 💾 📉. ✋️ 🚥 👆 **⚙️ 📚 💾** (🖼 ⏮️ **🎰 🏫** 🏷), 👆 🔜 ✅ ❔ 🌅 💾 👆 😩 &amp; 🔆 **🔢 📦** 👈 🏃 **🔠 🎰** (&amp; 🎲 🚮 🌖 🎰 👆 🌑).
 
@@ -497,14 +497,14 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 ## ⏮️ 🔁 ⏭ ▶️ &amp; 📦
 
-🚥 👆 ⚙️ 📦 (✅ ☁, Kubernete), ⤴️ 📤 2️⃣ 👑 🎯 👆 💪 ⚙️.
+🚥 👆 ⚙️ 📦 (✅ ☁, Kubernetes), ⤴️ 📤 2️⃣ 👑 🎯 👆 💪 ⚙️.
 
 ### 💗 📦
 
-🚥 👆 ✔️ **💗 📦**, 🎲 🔠 1️⃣ 🏃 **👁 🛠️** (🖼, **Kubernete** 🌑), ⤴️ 👆 🔜 🎲 💚 ✔️ **🎏 📦** 🔨 👷 **⏮️ 📶** 👁 📦, 🏃 👁 🛠️, **⏭** 🏃 🔁 👨‍🏭 📦.
+🚥 👆 ✔️ **💗 📦**, 🎲 🔠 1️⃣ 🏃 **👁 🛠️** (🖼, **Kubernetes** 🌑), ⤴️ 👆 🔜 🎲 💚 ✔️ **🎏 📦** 🔨 👷 **⏮️ 📶** 👁 📦, 🏃 👁 🛠️, **⏭** 🏃 🔁 👨‍🏭 📦.
 
 !!! info
-    🚥 👆 ⚙️ Kubernete, 👉 🔜 🎲 <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">🕑 📦</a>.
+    🚥 👆 ⚙️ Kubernetes, 👉 🔜 🎲 <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">🕑 📦</a>.
 
 🚥 👆 ⚙️ 💼 📤 🙅‍♂ ⚠ 🏃‍♂ 👈 ⏮️ 📶 **💗 🕰 🔗** (🖼 🚥 👆 🚫 🏃 💽 🛠️, ✋️ ✅ 🚥 💽 🔜), ⤴️ 👆 💪 🚮 👫 🔠 📦 ▶️️ ⏭ ▶️ 👑 🛠️.
 
@@ -574,7 +574,7 @@ COPY ./app /app/app
 
 ### 🕐❔ ⚙️
 
-👆 🔜 🎲 **🚫** ⚙️ 👉 🛂 🧢 🖼 (⚖️ 🙆 🎏 🎏 1️⃣) 🚥 👆 ⚙️ **Kubernete** (⚖️ 🎏) &amp; 👆 ⏪ ⚒ **🧬** 🌑 🎚, ⏮️ 💗 **📦**. 📚 💼, 👆 👍 📆 **🏗 🖼 ⚪️➡️ 🖌** 🔬 🔛: [🏗 ☁ 🖼 FastAPI](#build-a-docker-image-for-fastapi).
+👆 🔜 🎲 **🚫** ⚙️ 👉 🛂 🧢 🖼 (⚖️ 🙆 🎏 🎏 1️⃣) 🚥 👆 ⚙️ **Kubernetes** (⚖️ 🎏) &amp; 👆 ⏪ ⚒ **🧬** 🌑 🎚, ⏮️ 💗 **📦**. 📚 💼, 👆 👍 📆 **🏗 🖼 ⚪️➡️ 🖌** 🔬 🔛: [🏗 ☁ 🖼 FastAPI](#build-a-docker-image-for-fastapi).
 
 👉 🖼 🔜 ⚠ ✴️ 🎁 💼 🔬 🔛 [📦 ⏮️ 💗 🛠️ &amp; 🎁 💼](#containers-with-multiple-processes-and-special-cases). 🖼, 🚥 👆 🈸 **🙅 🥃** 👈 ⚒ 🔢 🔢 🛠️ ⚓️ 🔛 💽 👷 👍, 👆 🚫 💚 😥 ⏮️ ❎ 🛠️ 🧬 🌑 🎚, &amp; 👆 🚫 🏃 🌅 🌘 1️⃣ 📦 ⏮️ 👆 📱. ⚖️ 🚥 👆 🛠️ ⏮️ **☁ ✍**, 🏃 🔛 👁 💽, ♒️.
 
@@ -585,7 +585,7 @@ COPY ./app /app/app
 🖼:
 
 * ⏮️ **☁ ✍** 👁 💽
-* ⏮️ **Kubernete** 🌑
+* ⏮️ **Kubernetes** 🌑
 * ⏮️ ☁ 🐝 📳 🌑
 * ⏮️ ➕1️⃣ 🧰 💖 🖖
 * ⏮️ ☁ 🐕‍🦺 👈 ✊ 👆 📦 🖼 &amp; 🛠️ ⚫️
@@ -682,7 +682,7 @@ CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port"
 
 ## 🌃
 
-⚙️ 📦 ⚙️ (✅ ⏮️ **☁** &amp; **Kubernete**) ⚫️ ▶️️ 📶 🎯 🍵 🌐 **🛠️ 🔧**:
+⚙️ 📦 ⚙️ (✅ ⏮️ **☁** &amp; **Kubernetes**) ⚫️ ▶️️ 📶 🎯 🍵 🌐 **🛠️ 🔧**:
 
 * 🇺🇸🔍
 * 🏃‍♂ 🔛 🕴
diff --git a/docs/em/docs/deployment/server-workers.md b/docs/em/docs/deployment/server-workers.md
index ca068d744..b7e58c4f4 100644
--- a/docs/em/docs/deployment/server-workers.md
+++ b/docs/em/docs/deployment/server-workers.md
@@ -18,9 +18,9 @@
 📥 👤 🔜 🎦 👆 ❔ ⚙️ <a href="https://gunicorn.org/" class="external-link" target="_blank">**🐁**</a> ⏮️ **Uvicorn 👨‍🏭 🛠️**.
 
 !!! info
-    🚥 👆 ⚙️ 📦, 🖼 ⏮️ ☁ ⚖️ Kubernete, 👤 🔜 💬 👆 🌅 🔃 👈 ⏭ 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
+    🚥 👆 ⚙️ 📦, 🖼 ⏮️ ☁ ⚖️ Kubernetes, 👤 🔜 💬 👆 🌅 🔃 👈 ⏭ 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
 
-    🎯, 🕐❔ 🏃 🔛 **Kubernete** 👆 🔜 🎲 **🚫** 💚 ⚙️ 🐁 &amp; ↩️ 🏃 **👁 Uvicorn 🛠️ 📍 📦**, ✋️ 👤 🔜 💬 👆 🔃 ⚫️ ⏪ 👈 📃.
+    🎯, 🕐❔ 🏃 🔛 **Kubernetes** 👆 🔜 🎲 **🚫** 💚 ⚙️ 🐁 &amp; ↩️ 🏃 **👁 Uvicorn 🛠️ 📍 📦**, ✋️ 👤 🔜 💬 👆 🔃 ⚫️ ⏪ 👈 📃.
 
 ## 🐁 ⏮️ Uvicorn 👨‍🏭
 
@@ -167,7 +167,7 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
 
 👤 🔜 🎦 👆 **🛂 ☁ 🖼** 👈 🔌 **🐁 ⏮️ Uvicorn 👨‍🏭** &amp; 🔢 📳 👈 💪 ⚠ 🙅 💼.
 
-📤 👤 🔜 🎦 👆 ❔ **🏗 👆 👍 🖼 ⚪️➡️ 🖌** 🏃 👁 Uvicorn 🛠️ (🍵 🐁). ⚫️ 🙅 🛠️ &amp; 🎲 ⚫️❔ 👆 🔜 💚 🕐❔ ⚙️ 📎 📦 🧾 ⚙️ 💖 **Kubernete**.
+📤 👤 🔜 🎦 👆 ❔ **🏗 👆 👍 🖼 ⚪️➡️ 🖌** 🏃 👁 Uvicorn 🛠️ (🍵 🐁). ⚫️ 🙅 🛠️ &amp; 🎲 ⚫️❔ 👆 🔜 💚 🕐❔ ⚙️ 📎 📦 🧾 ⚙️ 💖 **Kubernetes**.
 
 ## 🌃
 
@@ -175,4 +175,4 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
 
 👆 💪 ⚙️ 👉 🧰 &amp; 💭 🚥 👆 ⚒ 🆙 **👆 👍 🛠️ ⚙️** ⏪ ✊ 💅 🎏 🛠️ 🔧 👆.
 
-✅ 👅 ⏭ 📃 💡 🔃 **FastAPI** ⏮️ 📦 (✅ ☁ &amp; Kubernete). 👆 🔜 👀 👈 👈 🧰 ✔️ 🙅 🌌 ❎ 🎏 **🛠️ 🔧** 👍. 👶
+✅ 👅 ⏭ 📃 💡 🔃 **FastAPI** ⏮️ 📦 (✅ ☁ &amp; Kubernetes). 👆 🔜 👀 👈 👈 🧰 ✔️ 🙅 🌌 ❎ 🎏 **🛠️ 🔧** 👍. 👶
diff --git a/docs/em/docs/external-links.md b/docs/em/docs/external-links.md
index 4440b1f12..5ba668bfa 100644
--- a/docs/em/docs/external-links.md
+++ b/docs/em/docs/external-links.md
@@ -11,77 +11,21 @@
 
 ## 📄
 
-### 🇪🇸
+{% for section_name, section_content in external_links.items() %}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+## {{ section_name }}
+
+{% 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>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### 🇯🇵
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### 🇻🇳
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### 🇷🇺
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### 🇩🇪
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### 🇹🇼
-
-{% if external_links %}
-{% for article in external_links.articles.taiwanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## 📻
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## 💬
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
 
 ## 🏗
 
diff --git a/docs/em/docs/help-fastapi.md b/docs/em/docs/help-fastapi.md
index d7b66185d..b998ade42 100644
--- a/docs/em/docs/help-fastapi.md
+++ b/docs/em/docs/help-fastapi.md
@@ -231,8 +231,6 @@
 
     ⚙️ 💬 🕴 🎏 🏢 💬.
 
-📤 ⏮️ <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">🥊 💬</a>, ✋️ ⚫️ 🚫 ✔️ 📻 &amp; 🏧 ⚒, 💬 🌖 ⚠, 😧 🔜 👍 ⚙️.
-
 ### 🚫 ⚙️ 💬 ❔
 
 ✔️ 🤯 👈 💬 ✔ 🌅 "🆓 💬", ⚫️ ⏩ 💭 ❔ 👈 💁‍♂️ 🏢 &amp; 🌅 ⚠ ❔,, 👆 💪 🚫 📨 ❔.
diff --git a/docs/em/docs/advanced/conditional-openapi.md b/docs/em/docs/how-to/conditional-openapi.md
similarity index 100%
rename from docs/em/docs/advanced/conditional-openapi.md
rename to docs/em/docs/how-to/conditional-openapi.md
diff --git a/docs/em/docs/advanced/custom-request-and-route.md b/docs/em/docs/how-to/custom-request-and-route.md
similarity index 100%
rename from docs/em/docs/advanced/custom-request-and-route.md
rename to docs/em/docs/how-to/custom-request-and-route.md
diff --git a/docs/em/docs/how-to/extending-openapi.md b/docs/em/docs/how-to/extending-openapi.md
new file mode 100644
index 000000000..6b3bc0075
--- /dev/null
+++ b/docs/em/docs/how-to/extending-openapi.md
@@ -0,0 +1,90 @@
+# ↔ 🗄
+
+!!! warning
+    👉 👍 🏧 ⚒. 👆 🎲 💪 🚶 ⚫️.
+
+    🚥 👆 📄 🔰 - 👩‍💻 🦮, 👆 💪 🎲 🚶 👉 📄.
+
+    🚥 👆 ⏪ 💭 👈 👆 💪 🔀 🏗 🗄 🔗, 😣 👂.
+
+📤 💼 🌐❔ 👆 💪 💪 🔀 🏗 🗄 🔗.
+
+👉 📄 👆 🔜 👀 ❔.
+
+## 😐 🛠️
+
+😐 (🔢) 🛠️, ⏩.
+
+`FastAPI` 🈸 (👐) ✔️ `.openapi()` 👩‍🔬 👈 📈 📨 🗄 🔗.
+
+🍕 🈸 🎚 🏗, *➡ 🛠️* `/openapi.json` (⚖️ ⚫️❔ 👆 ⚒ 👆 `openapi_url`) ®.
+
+⚫️ 📨 🎻 📨 ⏮️ 🏁 🈸 `.openapi()` 👩‍🔬.
+
+🔢, ⚫️❔ 👩‍🔬 `.openapi()` 🔨 ✅ 🏠 `.openapi_schema` 👀 🚥 ⚫️ ✔️ 🎚 &amp; 📨 👫.
+
+🚥 ⚫️ 🚫, ⚫️ 🏗 👫 ⚙️ 🚙 🔢 `fastapi.openapi.utils.get_openapi`.
+
+&amp; 👈 🔢 `get_openapi()` 📨 🔢:
+
+* `title`: 🗄 📛, 🎦 🩺.
+* `version`: ⏬ 👆 🛠️, ✅ `2.5.0`.
+* `openapi_version`: ⏬ 🗄 🔧 ⚙️. 🔢, ⏪: `3.0.2`.
+* `description`: 📛 👆 🛠️.
+* `routes`: 📇 🛣, 👫 🔠 ® *➡ 🛠️*. 👫 ✊ ⚪️➡️ `app.routes`.
+
+## 🔑 🔢
+
+⚙️ ℹ 🔛, 👆 💪 ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗 &amp; 🔐 🔠 🍕 👈 👆 💪.
+
+🖼, ➡️ 🚮 <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">📄 🗄 ↔ 🔌 🛃 🔱</a>.
+
+### 😐 **FastAPI**
+
+🥇, ✍ 🌐 👆 **FastAPI** 🈸 🛎:
+
+```Python hl_lines="1  4  7-9"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 🏗 🗄 🔗
+
+⤴️, ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗, 🔘 `custom_openapi()` 🔢:
+
+```Python hl_lines="2  15-20"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 🔀 🗄 🔗
+
+🔜 👆 💪 🚮 📄 ↔, ❎ 🛃 `x-logo` `info` "🎚" 🗄 🔗:
+
+```Python hl_lines="21-23"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 💾 🗄 🔗
+
+👆 💪 ⚙️ 🏠 `.openapi_schema` "💾", 🏪 👆 🏗 🔗.
+
+👈 🌌, 👆 🈸 🏆 🚫 ✔️ 🏗 🔗 🔠 🕰 👩‍💻 📂 👆 🛠️ 🩺.
+
+⚫️ 🔜 🏗 🕴 🕐, &amp; ⤴️ 🎏 💾 🔗 🔜 ⚙️ ⏭ 📨.
+
+```Python hl_lines="13-14  24-25"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 🔐 👩‍🔬
+
+🔜 👆 💪 ❎ `.openapi()` 👩‍🔬 ⏮️ 👆 🆕 🔢.
+
+```Python hl_lines="28"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### ✅ ⚫️
+
+🕐 👆 🚶 <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> 👆 🔜 👀 👈 👆 ⚙️ 👆 🛃 🔱 (👉 🖼, **FastAPI**'Ⓜ 🔱):
+
+<img src="/img/tutorial/extending-openapi/image01.png">
diff --git a/docs/em/docs/advanced/graphql.md b/docs/em/docs/how-to/graphql.md
similarity index 100%
rename from docs/em/docs/advanced/graphql.md
rename to docs/em/docs/how-to/graphql.md
diff --git a/docs/em/docs/advanced/sql-databases-peewee.md b/docs/em/docs/how-to/sql-databases-peewee.md
similarity index 100%
rename from docs/em/docs/advanced/sql-databases-peewee.md
rename to docs/em/docs/how-to/sql-databases-peewee.md
diff --git a/docs/em/docs/index.md b/docs/em/docs/index.md
index ea8a9d41c..c7df28160 100644
--- a/docs/em/docs/index.md
+++ b/docs/em/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI 🏛, ⏩ (↕-🎭), 🕸 🛠️ 🏗 🛠️ ⏮️ 🐍 3️⃣.7️⃣ ➕ ⚓️ 🔛 🐩 🐍 🆎 🔑.
+FastAPI 🏛, ⏩ (↕-🎭), 🕸 🛠️ 🏗 🛠️ ⏮️ 🐍 3️⃣.8️⃣ ➕ ⚓️ 🔛 🐩 🐍 🆎 🔑.
 
 🔑 ⚒:
 
diff --git a/docs/em/docs/project-generation.md b/docs/em/docs/project-generation.md
index 5fd667ad1..ae959e1d5 100644
--- a/docs/em/docs/project-generation.md
+++ b/docs/em/docs/project-generation.md
@@ -79,6 +79,6 @@
 * **🌈** 🕜 🏷 🛠️.
 * **☁ 🧠 🔎** 📨 📁 🏗.
 * **🏭 🔜** 🐍 🕸 💽 ⚙️ Uvicorn &amp; 🐁.
-* **☁ 👩‍💻** Kubernete (🦲) 🆑/💿 🛠️ 🏗.
+* **☁ 👩‍💻** Kubernetes (🦲) 🆑/💿 🛠️ 🏗.
 * **🤸‍♂** 💪 ⚒ 1️⃣ 🌈 🏗 🇪🇸 ⏮️ 🏗 🖥.
 * **💪 🏧** 🎏 🏷 🛠️ (Pytorch, 🇸🇲), 🚫 🌈.
diff --git a/docs/em/docs/tutorial/query-params-str-validations.md b/docs/em/docs/tutorial/query-params-str-validations.md
index d6b67bd51..f0e455abe 100644
--- a/docs/em/docs/tutorial/query-params-str-validations.md
+++ b/docs/em/docs/tutorial/query-params-str-validations.md
@@ -371,7 +371,7 @@ http://localhost:8000/items/
 
 === "🐍 3️⃣.1️⃣0️⃣ &amp; 🔛"
 
-    ```Python hl_lines="12"
+    ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
@@ -421,7 +421,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
 
 === "🐍 3️⃣.1️⃣0️⃣ &amp; 🔛"
 
-    ```Python hl_lines="17"
+    ```Python hl_lines="16"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
index ad738df35..726e7eae7 100644
--- a/docs/en/data/external_links.yml
+++ b/docs/en/data/external_links.yml
@@ -1,5 +1,9 @@
-articles:
-  english:
+Articles:
+  English:
+  - author: Adejumo Ridwan Suleiman
+    author_link: https://www.linkedin.com/in/adejumoridwan/
+    link: https://medium.com/python-in-plain-english/build-an-sms-spam-classifier-serverless-database-with-faunadb-and-fastapi-23dbb275bc5b
+    title: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI
   - author: Raf Rasenberg
     author_link: https://rafrasenberg.com/about/
     link: https://rafrasenberg.com/fastapi-lambda/
@@ -232,7 +236,7 @@ articles:
     author_link: https://medium.com/@krishnardt365
     link: https://medium.com/@krishnardt365/fastapi-docker-and-postgres-91943e71be92
     title: Fastapi, Docker(Docker compose) and Postgres
-  german:
+  German:
   - author: Marcel Sander (actidoo)
     author_link: https://www.actidoo.com
     link: https://www.actidoo.com/de/blog/python-fastapi-domain-driven-design
@@ -245,7 +249,7 @@ articles:
     author_link: https://hellocoding.de/autor/felix-schuermeyer/
     link: https://hellocoding.de/blog/coding-language/python/fastapi
     title: REST-API Programmieren mittels Python und dem FastAPI Modul
-  japanese:
+  Japanese:
   - author: '@bee2'
     author_link: https://qiita.com/bee2
     link: https://qiita.com/bee2/items/75d9c0d7ba20e7a4a0e9
@@ -294,7 +298,7 @@ articles:
     author_link: https://qiita.com/mtitg
     link: https://qiita.com/mtitg/items/47770e9a562dd150631d
     title: FastAPI｜DB接続してCRUDするPython製APIサーバーを構築
-  russian:
+  Russian:
   - author: Troy Köhler
     author_link: https://www.linkedin.com/in/trkohler/
     link: https://trkohler.com/fast-api-introduction-to-framework
@@ -307,18 +311,18 @@ articles:
     author_link: https://habr.com/ru/users/57uff3r/
     link: https://habr.com/ru/post/454440/
     title: 'Мелкая питонячая радость #2: Starlette - Солидная примочка – FastAPI'
-  vietnamese:
+  Vietnamese:
   - author: Nguyễn Nhân
     author_link: https://fullstackstation.com/author/figonking/
     link: https://fullstackstation.com/fastapi-trien-khai-bang-docker/
     title: 'FASTAPI: TRIỂN KHAI BẰNG DOCKER'
-  taiwanese:
+  Taiwanese:
   - author: Leon
     author_link: http://editor.leonh.space/
     link: https://editor.leonh.space/2022/tortoise/
     title: 'Tortoise ORM / FastAPI 整合快速筆記'
-podcasts:
-  english:
+Podcasts:
+  English:
   - author: Podcast.`__init__`
     author_link: https://www.pythonpodcast.com/
     link: https://www.pythonpodcast.com/fastapi-web-application-framework-episode-259/
@@ -327,8 +331,8 @@ podcasts:
     author_link: https://pythonbytes.fm/
     link: https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855
     title: FastAPI on PythonBytes
-talks:
-  english:
+Talks:
+  English:
   - author: Sebastián Ramírez (tiangolo)
     author_link: https://twitter.com/tiangolo
     link: https://www.youtube.com/watch?v=PnpTY1f4k2U
diff --git a/docs/en/data/github_sponsors.yml b/docs/en/data/github_sponsors.yml
index 56a886c68..b9d74ea7b 100644
--- a/docs/en/data/github_sponsors.yml
+++ b/docs/en/data/github_sponsors.yml
@@ -1,7 +1,16 @@
 sponsors:
-- - login: cryptapi
+- - login: bump-sh
+    avatarUrl: https://avatars.githubusercontent.com/u/33217836?v=4
+    url: https://github.com/bump-sh
+  - login: cryptapi
     avatarUrl: https://avatars.githubusercontent.com/u/44925437?u=61369138589bc7fee6c417f3fbd50fbd38286cc4&v=4
     url: https://github.com/cryptapi
+  - login: porter-dev
+    avatarUrl: https://avatars.githubusercontent.com/u/62078005?v=4
+    url: https://github.com/porter-dev
+  - login: fern-api
+    avatarUrl: https://avatars.githubusercontent.com/u/102944815?v=4
+    url: https://github.com/fern-api
   - login: nanram22
     avatarUrl: https://avatars.githubusercontent.com/u/116367316?v=4
     url: https://github.com/nanram22
@@ -14,6 +23,9 @@ sponsors:
 - - login: mikeckennedy
     avatarUrl: https://avatars.githubusercontent.com/u/2035561?u=1bb18268bcd4d9249e1f783a063c27df9a84c05b&v=4
     url: https://github.com/mikeckennedy
+  - login: ndimares
+    avatarUrl: https://avatars.githubusercontent.com/u/6267663?u=cfb27efde7a7212be8142abb6c058a1aeadb41b1&v=4
+    url: https://github.com/ndimares
   - login: deta
     avatarUrl: https://avatars.githubusercontent.com/u/47275976?v=4
     url: https://github.com/deta
@@ -29,33 +41,27 @@ sponsors:
   - login: VincentParedes
     avatarUrl: https://avatars.githubusercontent.com/u/103889729?v=4
     url: https://github.com/VincentParedes
-- - login: getsentry
-    avatarUrl: https://avatars.githubusercontent.com/u/1396951?v=4
-    url: https://github.com/getsentry
-- - login: takashi-yoneya
+- - login: acsone
+    avatarUrl: https://avatars.githubusercontent.com/u/7601056?v=4
+    url: https://github.com/acsone
+  - login: takashi-yoneya
     avatarUrl: https://avatars.githubusercontent.com/u/33813153?u=2d0522bceba0b8b69adf1f2db866503bd96f944e&v=4
     url: https://github.com/takashi-yoneya
-  - login: mercedes-benz
-    avatarUrl: https://avatars.githubusercontent.com/u/34240465?v=4
-    url: https://github.com/mercedes-benz
   - login: xoflare
     avatarUrl: https://avatars.githubusercontent.com/u/74335107?v=4
     url: https://github.com/xoflare
   - login: marvin-robot
     avatarUrl: https://avatars.githubusercontent.com/u/41086007?u=091c5cb75af363123d66f58194805a97220ee1a7&v=4
     url: https://github.com/marvin-robot
-  - login: Flint-company
-    avatarUrl: https://avatars.githubusercontent.com/u/48908872?u=355cd3d8992d4be8173058e7000728757c55ad49&v=4
-    url: https://github.com/Flint-company
   - login: BoostryJP
     avatarUrl: https://avatars.githubusercontent.com/u/57932412?v=4
     url: https://github.com/BoostryJP
+  - login: jina-ai
+    avatarUrl: https://avatars.githubusercontent.com/u/60539444?v=4
+    url: https://github.com/jina-ai
 - - login: HiredScore
     avatarUrl: https://avatars.githubusercontent.com/u/3908850?v=4
     url: https://github.com/HiredScore
-  - login: petebachant
-    avatarUrl: https://avatars.githubusercontent.com/u/4604869?u=b17a5a4ac82f77b7efff864d439e8068d2a36593&v=4
-    url: https://github.com/petebachant
   - login: Trivie
     avatarUrl: https://avatars.githubusercontent.com/u/8161763?v=4
     url: https://github.com/Trivie
@@ -71,12 +77,6 @@ sponsors:
   - login: AccentDesign
     avatarUrl: https://avatars.githubusercontent.com/u/2429332?v=4
     url: https://github.com/AccentDesign
-  - login: RodneyU215
-    avatarUrl: https://avatars.githubusercontent.com/u/3329665?u=ec6a9adf8e7e8e306eed7d49687c398608d1604f&v=4
-    url: https://github.com/RodneyU215
-  - login: tizz98
-    avatarUrl: https://avatars.githubusercontent.com/u/5739698?u=f095a3659e3a8e7c69ccd822696990b521ea25f9&v=4
-    url: https://github.com/tizz98
   - login: americanair
     avatarUrl: https://avatars.githubusercontent.com/u/12281813?v=4
     url: https://github.com/americanair
@@ -89,14 +89,14 @@ sponsors:
   - login: primer-io
     avatarUrl: https://avatars.githubusercontent.com/u/62146168?v=4
     url: https://github.com/primer-io
-- - login: indeedeng
-    avatarUrl: https://avatars.githubusercontent.com/u/2905043?v=4
-    url: https://github.com/indeedeng
+- - login: NateXVI
+    avatarUrl: https://avatars.githubusercontent.com/u/48195620?u=4bc8751ae50cb087c40c1fe811764aa070b9eea6&v=4
+    url: https://github.com/NateXVI
 - - login: Kludex
     avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
     url: https://github.com/Kludex
   - login: samuelcolvin
-    avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=807390ba9cfe23906c3bf8a0d56aaca3cf2bfa0d&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4
     url: https://github.com/samuelcolvin
   - login: jefftriplett
     avatarUrl: https://avatars.githubusercontent.com/u/50527?u=af1ddfd50f6afd6d99f333ba2ac8d0a5b245ea74&v=4
@@ -104,12 +104,6 @@ sponsors:
   - login: jstanden
     avatarUrl: https://avatars.githubusercontent.com/u/63288?u=c3658d57d2862c607a0e19c2101c3c51876e36ad&v=4
     url: https://github.com/jstanden
-  - login: kamalgill
-    avatarUrl: https://avatars.githubusercontent.com/u/133923?u=0df9181d97436ce330e9acf90ab8a54b7022efe7&v=4
-    url: https://github.com/kamalgill
-  - login: dekoza
-    avatarUrl: https://avatars.githubusercontent.com/u/210980?u=c03c78a8ae1039b500dfe343665536ebc51979b2&v=4
-    url: https://github.com/dekoza
   - login: pamelafox
     avatarUrl: https://avatars.githubusercontent.com/u/297042?v=4
     url: https://github.com/pamelafox
@@ -137,9 +131,6 @@ sponsors:
   - login: mickaelandrieu
     avatarUrl: https://avatars.githubusercontent.com/u/1247388?u=599f6e73e452a9453f2bd91e5c3100750e731ad4&v=4
     url: https://github.com/mickaelandrieu
-  - login: jonakoudijs
-    avatarUrl: https://avatars.githubusercontent.com/u/1906344?u=5ca0c9a1a89b6a2ba31abe35c66bdc07af60a632&v=4
-    url: https://github.com/jonakoudijs
   - login: Shark009
     avatarUrl: https://avatars.githubusercontent.com/u/3163309?u=0c6f4091b0eda05c44c390466199826e6dc6e431&v=4
     url: https://github.com/Shark009
@@ -149,6 +140,9 @@ sponsors:
   - login: zsinx6
     avatarUrl: https://avatars.githubusercontent.com/u/3532625?u=ba75a5dc744d1116ccfeaaf30d41cb2fe81fe8dd&v=4
     url: https://github.com/zsinx6
+  - login: kennywakeland
+    avatarUrl: https://avatars.githubusercontent.com/u/3631417?u=7c8f743f1ae325dfadea7c62bbf1abd6a824fc55&v=4
+    url: https://github.com/kennywakeland
   - login: aacayaco
     avatarUrl: https://avatars.githubusercontent.com/u/3634801?u=eaadda178c964178fcb64886f6c732172c8f8219&v=4
     url: https://github.com/aacayaco
@@ -191,15 +185,12 @@ sponsors:
   - login: hiancdtrsnm
     avatarUrl: https://avatars.githubusercontent.com/u/7343177?v=4
     url: https://github.com/hiancdtrsnm
-  - login: Shackelford-Arden
-    avatarUrl: https://avatars.githubusercontent.com/u/7362263?v=4
-    url: https://github.com/Shackelford-Arden
-  - login: savannahostrowski
-    avatarUrl: https://avatars.githubusercontent.com/u/8949415?u=c3177aa099fb2b8c36aeba349278b77f9a8df211&v=4
-    url: https://github.com/savannahostrowski
   - login: wdwinslow
     avatarUrl: https://avatars.githubusercontent.com/u/11562137?u=dc01daafb354135603a263729e3d26d939c0c452&v=4
     url: https://github.com/wdwinslow
+  - login: jsoques
+    avatarUrl: https://avatars.githubusercontent.com/u/12414216?u=620921d94196546cc8b9eae2cc4cbc3f95bab42f&v=4
+    url: https://github.com/jsoques
   - login: joeds13
     avatarUrl: https://avatars.githubusercontent.com/u/13631604?u=628eb122e08bef43767b3738752b883e8e7f6259&v=4
     url: https://github.com/joeds13
@@ -221,9 +212,9 @@ sponsors:
   - login: Filimoa
     avatarUrl: https://avatars.githubusercontent.com/u/21352040?u=0be845711495bbd7b756e13fcaeb8efc1ebd78ba&v=4
     url: https://github.com/Filimoa
-  - login: LarryGF
-    avatarUrl: https://avatars.githubusercontent.com/u/26148349?u=431bb34d36d41c172466252242175281ae132152&v=4
-    url: https://github.com/LarryGF
+  - login: rahulsalgare
+    avatarUrl: https://avatars.githubusercontent.com/u/21974430?u=ade6f182b94554ab8491d7421de5e78f711dcaf8&v=4
+    url: https://github.com/rahulsalgare
   - login: BrettskiPy
     avatarUrl: https://avatars.githubusercontent.com/u/30988215?u=d8a94a67e140d5ee5427724b292cc52d8827087a&v=4
     url: https://github.com/BrettskiPy
@@ -233,18 +224,15 @@ sponsors:
   - login: Leay15
     avatarUrl: https://avatars.githubusercontent.com/u/32212558?u=c4aa9c1737e515959382a5515381757b1fd86c53&v=4
     url: https://github.com/Leay15
+  - login: dvlpjrs
+    avatarUrl: https://avatars.githubusercontent.com/u/32254642?u=fbd6ad0324d4f1eb6231cf775be1c7bd4404e961&v=4
+    url: https://github.com/dvlpjrs
   - login: ygorpontelo
     avatarUrl: https://avatars.githubusercontent.com/u/32963605?u=35f7103f9c4c4c2589ae5737ee882e9375ef072e&v=4
     url: https://github.com/ygorpontelo
-  - login: AlrasheedA
-    avatarUrl: https://avatars.githubusercontent.com/u/33544979?u=7fe66bf62b47682612b222e3e8f4795ef3be769b&v=4
-    url: https://github.com/AlrasheedA
   - login: ProteinQure
     avatarUrl: https://avatars.githubusercontent.com/u/33707203?v=4
     url: https://github.com/ProteinQure
-  - login: askurihin
-    avatarUrl: https://avatars.githubusercontent.com/u/37978981?v=4
-    url: https://github.com/askurihin
   - login: arleybri18
     avatarUrl: https://avatars.githubusercontent.com/u/39681546?u=5c028f81324b0e8c73b3c15bc4e7b0218d2ba0c3&v=4
     url: https://github.com/arleybri18
@@ -263,36 +251,24 @@ sponsors:
   - login: dudikbender
     avatarUrl: https://avatars.githubusercontent.com/u/53487583?u=3a57542938ebfd57579a0111db2b297e606d9681&v=4
     url: https://github.com/dudikbender
-  - login: thisistheplace
-    avatarUrl: https://avatars.githubusercontent.com/u/57633545?u=a3f3a7f8ace8511c6c067753f6eb6aee0db11ac6&v=4
-    url: https://github.com/thisistheplace
   - login: yakkonaut
     avatarUrl: https://avatars.githubusercontent.com/u/60633704?u=90a71fd631aa998ba4a96480788f017c9904e07b&v=4
     url: https://github.com/yakkonaut
   - login: patsatsia
     avatarUrl: https://avatars.githubusercontent.com/u/61111267?u=3271b85f7a37b479c8d0ae0a235182e83c166edf&v=4
     url: https://github.com/patsatsia
-  - login: daverin
-    avatarUrl: https://avatars.githubusercontent.com/u/70378377?u=6d1814195c0de7162820eaad95a25b423a3869c0&v=4
-    url: https://github.com/daverin
   - login: anthonycepeda
     avatarUrl: https://avatars.githubusercontent.com/u/72019805?u=4252c6b6dc5024af502a823a3ac5e7a03a69963f&v=4
     url: https://github.com/anthonycepeda
   - login: DelfinaCare
     avatarUrl: https://avatars.githubusercontent.com/u/83734439?v=4
     url: https://github.com/DelfinaCare
-  - login: khoadaniel
-    avatarUrl: https://avatars.githubusercontent.com/u/84840546?v=4
-    url: https://github.com/khoadaniel
   - login: osawa-koki
     avatarUrl: https://avatars.githubusercontent.com/u/94336223?u=59c6fe6945bcbbaff87b2a794238671b060620d2&v=4
     url: https://github.com/osawa-koki
   - login: pyt3h
     avatarUrl: https://avatars.githubusercontent.com/u/99658549?v=4
     url: https://github.com/pyt3h
-  - login: Dagmaara
-    avatarUrl: https://avatars.githubusercontent.com/u/115501964?v=4
-    url: https://github.com/Dagmaara
 - - login: SebTota
     avatarUrl: https://avatars.githubusercontent.com/u/25122511?v=4
     url: https://github.com/SebTota
@@ -305,6 +281,9 @@ sponsors:
   - login: bryanculbertson
     avatarUrl: https://avatars.githubusercontent.com/u/144028?u=defda4f90e93429221cc667500944abde60ebe4a&v=4
     url: https://github.com/bryanculbertson
+  - login: yourkin
+    avatarUrl: https://avatars.githubusercontent.com/u/178984?u=b43a7e5f8818f7d9083d3b110118d9c27d48a794&v=4
+    url: https://github.com/yourkin
   - login: slafs
     avatarUrl: https://avatars.githubusercontent.com/u/210173?v=4
     url: https://github.com/slafs
@@ -320,21 +299,18 @@ sponsors:
   - login: securancy
     avatarUrl: https://avatars.githubusercontent.com/u/606673?v=4
     url: https://github.com/securancy
-  - login: hardbyte
-    avatarUrl: https://avatars.githubusercontent.com/u/855189?u=aa29e92f34708814d6b67fcd47ca4cf2ce1c04ed&v=4
-    url: https://github.com/hardbyte
   - login: browniebroke
     avatarUrl: https://avatars.githubusercontent.com/u/861044?u=5abfca5588f3e906b31583d7ee62f6de4b68aa24&v=4
     url: https://github.com/browniebroke
   - login: janfilips
-    avatarUrl: https://avatars.githubusercontent.com/u/870699?u=96df18ad355e58b9397accc55f4eeb7a86e959b0&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/870699?u=80702ec63f14e675cd4cdcc6ce3821d2ed207fd7&v=4
     url: https://github.com/janfilips
+  - login: dodo5522
+    avatarUrl: https://avatars.githubusercontent.com/u/1362607?u=9bf1e0e520cccc547c046610c468ce6115bbcf9f&v=4
+    url: https://github.com/dodo5522
   - login: WillHogan
     avatarUrl: https://avatars.githubusercontent.com/u/1661551?u=7036c064cf29781470573865264ec8e60b6b809f&v=4
     url: https://github.com/WillHogan
-  - login: NateShoffner
-    avatarUrl: https://avatars.githubusercontent.com/u/1712163?u=b43cc2fa3fd8bec54b7706e4b98b72543c7bfea8&v=4
-    url: https://github.com/NateShoffner
   - login: my3
     avatarUrl: https://avatars.githubusercontent.com/u/1825270?v=4
     url: https://github.com/my3
@@ -344,12 +320,6 @@ sponsors:
   - login: cbonoz
     avatarUrl: https://avatars.githubusercontent.com/u/2351087?u=fd3e8030b2cc9fbfbb54a65e9890c548a016f58b&v=4
     url: https://github.com/cbonoz
-  - login: Patechoc
-    avatarUrl: https://avatars.githubusercontent.com/u/2376641?u=23b49e9eda04f078cb74fa3f93593aa6a57bb138&v=4
-    url: https://github.com/Patechoc
-  - login: larsvik
-    avatarUrl: https://avatars.githubusercontent.com/u/3442226?v=4
-    url: https://github.com/larsvik
   - login: anthonycorletti
     avatarUrl: https://avatars.githubusercontent.com/u/3477132?v=4
     url: https://github.com/anthonycorletti
@@ -359,6 +329,9 @@ sponsors:
   - login: Alisa-lisa
     avatarUrl: https://avatars.githubusercontent.com/u/4137964?u=e7e393504f554f4ff15863a1e01a5746863ef9ce&v=4
     url: https://github.com/Alisa-lisa
+  - login: piotrgredowski
+    avatarUrl: https://avatars.githubusercontent.com/u/4294480?v=4
+    url: https://github.com/piotrgredowski
   - login: danielunderwood
     avatarUrl: https://avatars.githubusercontent.com/u/4472301?v=4
     url: https://github.com/danielunderwood
@@ -380,9 +353,9 @@ sponsors:
   - login: katnoria
     avatarUrl: https://avatars.githubusercontent.com/u/7674948?u=09767eb13e07e09496c5fee4e5ce21d9eac34a56&v=4
     url: https://github.com/katnoria
-  - login: mattwelke
-    avatarUrl: https://avatars.githubusercontent.com/u/7719209?u=80f02a799323b1472b389b836d95957c93a6d856&v=4
-    url: https://github.com/mattwelke
+  - login: harsh183
+    avatarUrl: https://avatars.githubusercontent.com/u/7780198?v=4
+    url: https://github.com/harsh183
   - login: hcristea
     avatarUrl: https://avatars.githubusercontent.com/u/7814406?u=61d7a4fcf846983a4606788eac25e1c6c1209ba8&v=4
     url: https://github.com/hcristea
@@ -425,24 +398,30 @@ sponsors:
   - login: jangia
     avatarUrl: https://avatars.githubusercontent.com/u/17927101?u=9261b9bb0c3e3bb1ecba43e8915dc58d8c9a077e&v=4
     url: https://github.com/jangia
+  - login: timzaz
+    avatarUrl: https://avatars.githubusercontent.com/u/19709244?u=264d7db95c28156363760229c30ee1116efd4eeb&v=4
+    url: https://github.com/timzaz
   - login: shuheng-liu
     avatarUrl: https://avatars.githubusercontent.com/u/22414322?u=813c45f30786c6b511b21a661def025d8f7b609e&v=4
     url: https://github.com/shuheng-liu
-  - login: ghandic
-    avatarUrl: https://avatars.githubusercontent.com/u/23500353?u=e2e1d736f924d9be81e8bfc565b6d8836ba99773&v=4
-    url: https://github.com/ghandic
   - login: pers0n4
     avatarUrl: https://avatars.githubusercontent.com/u/24864600?u=f211a13a7b572cbbd7779b9c8d8cb428cc7ba07e&v=4
     url: https://github.com/pers0n4
   - login: kxzk
     avatarUrl: https://avatars.githubusercontent.com/u/25046261?u=e185e58080090f9e678192cd214a14b14a2b232b&v=4
     url: https://github.com/kxzk
+  - login: nisutec
+    avatarUrl: https://avatars.githubusercontent.com/u/25281462?u=e562484c451fdfc59053163f64405f8eb262b8b0&v=4
+    url: https://github.com/nisutec
   - login: hoenie-ams
     avatarUrl: https://avatars.githubusercontent.com/u/25708487?u=cda07434f0509ac728d9edf5e681117c0f6b818b&v=4
     url: https://github.com/hoenie-ams
   - login: joerambo
     avatarUrl: https://avatars.githubusercontent.com/u/26282974?v=4
     url: https://github.com/joerambo
+  - login: msniezynski
+    avatarUrl: https://avatars.githubusercontent.com/u/27588547?u=0e3be5ac57dcfdf124f470bcdf74b5bf79af1b6c&v=4
+    url: https://github.com/msniezynski
   - login: rlnchow
     avatarUrl: https://avatars.githubusercontent.com/u/28018479?u=a93ca9cf1422b9ece155784a72d5f2fdbce7adff&v=4
     url: https://github.com/rlnchow
@@ -456,17 +435,20 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/33275230?u=eb223cad27017bb1e936ee9b429b450d092d0236&v=4
     url: https://github.com/engineerjoe440
   - login: bnkc
-    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=527044d90b5ebb7f8dad517db5da1f45253b774b&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=1a104991a2ea90bfe304bc0b9ef191c7e4891a0e&v=4
     url: https://github.com/bnkc
-  - login: devbruce
-    avatarUrl: https://avatars.githubusercontent.com/u/35563380?u=ca4e811ac7f7b3eb1600fa63285119fcdee01188&v=4
-    url: https://github.com/devbruce
   - login: declon
     avatarUrl: https://avatars.githubusercontent.com/u/36180226?v=4
     url: https://github.com/declon
   - login: miraedbswo
     avatarUrl: https://avatars.githubusercontent.com/u/36796047?u=9e7a5b3e558edc61d35d0f9dfac37541bae7f56d&v=4
     url: https://github.com/miraedbswo
+  - login: DSMilestone6538
+    avatarUrl: https://avatars.githubusercontent.com/u/37230924?u=f299dce910366471523155e0cb213356d34aadc1&v=4
+    url: https://github.com/DSMilestone6538
+  - login: curegit
+    avatarUrl: https://avatars.githubusercontent.com/u/37978051?u=1733c322079118c0cdc573c03d92813f50a9faec&v=4
+    url: https://github.com/curegit
   - login: kristiangronberg
     avatarUrl: https://avatars.githubusercontent.com/u/42678548?v=4
     url: https://github.com/kristiangronberg
@@ -476,6 +458,9 @@ sponsors:
   - login: ArtyomVancyan
     avatarUrl: https://avatars.githubusercontent.com/u/44609997?v=4
     url: https://github.com/ArtyomVancyan
+  - login: josehenriqueroveda
+    avatarUrl: https://avatars.githubusercontent.com/u/46685746?u=2e672057a7dbe1dba47e57c378fc0cac336022eb&v=4
+    url: https://github.com/josehenriqueroveda
   - login: hgalytoby
     avatarUrl: https://avatars.githubusercontent.com/u/50397689?u=f4888c2c54929bd86eed0d3971d09fcb306e5088&v=4
     url: https://github.com/hgalytoby
@@ -485,27 +470,39 @@ sponsors:
   - login: conservative-dude
     avatarUrl: https://avatars.githubusercontent.com/u/55538308?u=f250c44942ea6e73a6bd90739b381c470c192c11&v=4
     url: https://github.com/conservative-dude
-  - login: leo-jp-edwards
-    avatarUrl: https://avatars.githubusercontent.com/u/58213433?u=2c128e8b0794b7a66211cd7d8ebe05db20b7e9c0&v=4
-    url: https://github.com/leo-jp-edwards
   - login: 0417taehyun
     avatarUrl: https://avatars.githubusercontent.com/u/63915557?u=47debaa860fd52c9b98c97ef357ddcec3b3fb399&v=4
     url: https://github.com/0417taehyun
+  - login: romabozhanovgithub
+    avatarUrl: https://avatars.githubusercontent.com/u/67696229?u=e4b921eef096415300425aca249348f8abb78ad7&v=4
+    url: https://github.com/romabozhanovgithub
+  - login: mbukeRepo
+    avatarUrl: https://avatars.githubusercontent.com/u/70356088?u=d2eb23e2b222a3b316c4183b05a3236b32819dc2&v=4
+    url: https://github.com/mbukeRepo
 - - login: ssbarnea
     avatarUrl: https://avatars.githubusercontent.com/u/102495?u=b4bf6818deefe59952ac22fec6ed8c76de1b8f7c&v=4
     url: https://github.com/ssbarnea
-  - login: tomast1337
-    avatarUrl: https://avatars.githubusercontent.com/u/15125899?u=2c2f2907012d820499e2c43632389184923513fe&v=4
-    url: https://github.com/tomast1337
+  - login: Patechoc
+    avatarUrl: https://avatars.githubusercontent.com/u/2376641?u=23b49e9eda04f078cb74fa3f93593aa6a57bb138&v=4
+    url: https://github.com/Patechoc
+  - login: LanceMoe
+    avatarUrl: https://avatars.githubusercontent.com/u/18505474?u=7fd3ead4364bdf215b6d75cb122b3811c391ef6b&v=4
+    url: https://github.com/LanceMoe
   - login: sadikkuzu
     avatarUrl: https://avatars.githubusercontent.com/u/23168063?u=d179c06bb9f65c4167fcab118526819f8e0dac17&v=4
     url: https://github.com/sadikkuzu
-  - login: ruizdiazever
-    avatarUrl: https://avatars.githubusercontent.com/u/29817086?u=2df54af55663d246e3a4dc8273711c37f1adb117&v=4
-    url: https://github.com/ruizdiazever
+  - login: samnimoh
+    avatarUrl: https://avatars.githubusercontent.com/u/33413170?u=147bc516be6cb647b28d7e3b3fea3a018a331145&v=4
+    url: https://github.com/samnimoh
   - login: danburonline
     avatarUrl: https://avatars.githubusercontent.com/u/34251194?u=2cad4388c1544e539ecb732d656e42fb07b4ff2d&v=4
     url: https://github.com/danburonline
   - login: rwxd
     avatarUrl: https://avatars.githubusercontent.com/u/40308458?u=cd04a39e3655923be4f25c2ba8a5a07b3da3230a&v=4
     url: https://github.com/rwxd
+  - login: shywn-mrk
+    avatarUrl: https://avatars.githubusercontent.com/u/51455763?u=389e2608e4056fe5e1f23e9ad56a9415277504d3&v=4
+    url: https://github.com/shywn-mrk
+  - login: almeida-matheus
+    avatarUrl: https://avatars.githubusercontent.com/u/66216198?u=54335eaa0ced626be5c1ff52fead1ebc032286ec&v=4
+    url: https://github.com/almeida-matheus
diff --git a/docs/en/data/people.yml b/docs/en/data/people.yml
index dd2dbe5ea..db06cbdaf 100644
--- a/docs/en/data/people.yml
+++ b/docs/en/data/people.yml
@@ -1,16 +1,16 @@
 maintainers:
 - login: tiangolo
-  answers: 1844
-  prs: 430
+  answers: 1868
+  prs: 496
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=740f11212a731f56798f558ceddb0bd07642afa7&v=4
   url: https://github.com/tiangolo
 experts:
 - login: Kludex
-  count: 434
+  count: 501
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: dmontagu
-  count: 237
+  count: 240
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
 - login: Mause
@@ -25,34 +25,34 @@ experts:
   count: 193
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
   url: https://github.com/JarroVGIT
-- login: euri10
-  count: 152
-  avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
-  url: https://github.com/euri10
 - login: jgould22
-  count: 139
+  count: 168
   avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
   url: https://github.com/jgould22
+- login: euri10
+  count: 153
+  avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
+  url: https://github.com/euri10
 - login: phy25
   count: 126
-  avatarUrl: https://avatars.githubusercontent.com/u/331403?u=191cd73f0c936497c8d1931a217bb3039d050265&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/331403?v=4
   url: https://github.com/phy25
 - login: iudeen
-  count: 118
+  count: 122
   avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
   url: https://github.com/iudeen
 - login: raphaelauv
   count: 83
   avatarUrl: https://avatars.githubusercontent.com/u/10202690?u=e6f86f5c0c3026a15d6b51792fa3e532b12f1371&v=4
   url: https://github.com/raphaelauv
-- login: ghandic
-  count: 71
-  avatarUrl: https://avatars.githubusercontent.com/u/23500353?u=e2e1d736f924d9be81e8bfc565b6d8836ba99773&v=4
-  url: https://github.com/ghandic
 - login: ArcLightSlavik
   count: 71
   avatarUrl: https://avatars.githubusercontent.com/u/31127044?u=b0f2c37142f4b762e41ad65dc49581813422bd71&v=4
   url: https://github.com/ArcLightSlavik
+- login: ghandic
+  count: 71
+  avatarUrl: https://avatars.githubusercontent.com/u/23500353?u=e2e1d736f924d9be81e8bfc565b6d8836ba99773&v=4
+  url: https://github.com/ghandic
 - login: falkben
   count: 57
   avatarUrl: https://avatars.githubusercontent.com/u/653031?u=ad9838e089058c9e5a0bab94c0eec7cc181e0cd0&v=4
@@ -61,14 +61,6 @@ experts:
   count: 49
   avatarUrl: https://avatars.githubusercontent.com/u/516999?u=437c0c5038558c67e887ccd863c1ba0f846c03da&v=4
   url: https://github.com/sm-Fifteen
-- login: adriangb
-  count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
-  url: https://github.com/adriangb
-- login: yinziyan1206
-  count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
-  url: https://github.com/yinziyan1206
 - login: acidjunk
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
@@ -81,30 +73,42 @@ experts:
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/27180793?u=5cf2877f50b3eb2bc55086089a78a36f07042889&v=4
   url: https://github.com/Dustyposa
+- login: adriangb
+  count: 45
+  avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
+  url: https://github.com/adriangb
+- login: yinziyan1206
+  count: 44
+  avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
+  url: https://github.com/yinziyan1206
 - login: odiseo0
   count: 43
-  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=2da05dab6cc8e1ade557801634760a56e4101796&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
   url: https://github.com/odiseo0
 - login: frankie567
   count: 43
-  avatarUrl: https://avatars.githubusercontent.com/u/1144727?u=85c025e3fcc7bd79a5665c63ee87cdf8aae13374&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/1144727?u=c159fe047727aedecbbeeaa96a1b03ceb9d39add&v=4
   url: https://github.com/frankie567
 - login: includeamin
   count: 40
   avatarUrl: https://avatars.githubusercontent.com/u/11836741?u=8bd5ef7e62fe6a82055e33c4c0e0a7879ff8cfb6&v=4
   url: https://github.com/includeamin
+- login: chbndrhnns
+  count: 38
+  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
+  url: https://github.com/chbndrhnns
 - login: STeveShary
   count: 37
   avatarUrl: https://avatars.githubusercontent.com/u/5167622?u=de8f597c81d6336fcebc37b32dfd61a3f877160c&v=4
   url: https://github.com/STeveShary
-- login: chbndrhnns
-  count: 35
-  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
-  url: https://github.com/chbndrhnns
 - login: krishnardt
   count: 35
   avatarUrl: https://avatars.githubusercontent.com/u/31960541?u=47f4829c77f4962ab437ffb7995951e41eeebe9b&v=4
   url: https://github.com/krishnardt
+- login: n8sty
+  count: 32
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
 - login: panla
   count: 32
   avatarUrl: https://avatars.githubusercontent.com/u/41326348?u=ba2fda6b30110411ecbf406d187907e2b420ac19&v=4
@@ -126,33 +130,41 @@ experts:
   avatarUrl: https://avatars.githubusercontent.com/u/9435877?u=719327b7d2c4c62212456d771bfa7c6b8dbb9eac&v=4
   url: https://github.com/SirTelemak
 - login: acnebs
-  count: 22
-  avatarUrl: https://avatars.githubusercontent.com/u/9054108?u=c27e50269f1ef8ea950cc6f0268c8ec5cebbe9c9&v=4
+  count: 23
+  avatarUrl: https://avatars.githubusercontent.com/u/9054108?v=4
   url: https://github.com/acnebs
 - login: rafsaf
   count: 21
-  avatarUrl: https://avatars.githubusercontent.com/u/51059348?u=f8f0d6d6e90fac39fa786228158ba7f013c74271&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/51059348?u=5fe59a56e1f2f9ccd8005d71752a8276f133ae1a&v=4
   url: https://github.com/rafsaf
-- login: chris-allnutt
+- login: JavierSanchezCastro
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
-  url: https://github.com/chris-allnutt
+  avatarUrl: https://avatars.githubusercontent.com/u/72013291?u=ae5679e6bd971d9d98cd5e76e8683f83642ba950&v=4
+  url: https://github.com/JavierSanchezCastro
 - login: nsidnev
   count: 20
   avatarUrl: https://avatars.githubusercontent.com/u/22559461?u=a9cc3238217e21dc8796a1a500f01b722adb082c&v=4
   url: https://github.com/nsidnev
-- login: n8sty
-  count: 18
-  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
-  url: https://github.com/n8sty
-- login: retnikt
-  count: 18
-  avatarUrl: https://avatars.githubusercontent.com/u/24581770?v=4
-  url: https://github.com/retnikt
+- login: chris-allnutt
+  count: 20
+  avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
+  url: https://github.com/chris-allnutt
+- login: chrisK824
+  count: 19
+  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
+  url: https://github.com/chrisK824
 - login: zoliknemet
   count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/22326718?u=31ba446ac290e23e56eea8e4f0c558aaf0b40779&v=4
   url: https://github.com/zoliknemet
+- login: retnikt
+  count: 18
+  avatarUrl: https://avatars.githubusercontent.com/u/24581770?v=4
+  url: https://github.com/retnikt
+- login: ebottos94
+  count: 17
+  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
+  url: https://github.com/ebottos94
 - login: Hultner
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/2669034?u=115e53df959309898ad8dc9443fbb35fee71df07&v=4
@@ -169,6 +181,10 @@ experts:
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/16540232?u=05d2beb8e034d584d0a374b99d8826327bd7f614&v=4
   url: https://github.com/caeser1996
+- login: nymous
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
+  url: https://github.com/nymous
 - login: jonatasoli
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/26334101?u=071c062d2861d3dd127f6b4a5258cd8ef55d4c50&v=4
@@ -181,55 +197,23 @@ experts:
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
   url: https://github.com/abhint
-- login: nymous
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
-  url: https://github.com/nymous
-- login: ghost
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/10137?u=b1951d34a583cf12ec0d3b0781ba19be97726318&v=4
-  url: https://github.com/ghost
-- login: simondale00
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/33907262?v=4
-  url: https://github.com/simondale00
-- login: jorgerpo
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/12537771?u=7444d20019198e34911082780cc7ad73f2b97cb3&v=4
-  url: https://github.com/jorgerpo
 last_month_active:
-- login: jgould22
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
-  url: https://github.com/jgould22
 - login: Kludex
-  count: 13
+  count: 8
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
-- login: abhint
-  count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
-  url: https://github.com/abhint
+- login: n8sty
+  count: 7
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
 - login: chrisK824
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
   url: https://github.com/chrisK824
-- login: arjwilliams
+- login: danielfcollier
   count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/22227620?v=4
-  url: https://github.com/arjwilliams
-- login: wu-clan
-  count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/52145145?u=f8c9e5c8c259d248e1683fedf5027b4ee08a0967&v=4
-  url: https://github.com/wu-clan
-- login: Ahmed-Abdou14
-  count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/104530599?u=d1e1c064d57c3ad5b6481716928da840f6d5a492&v=4
-  url: https://github.com/Ahmed-Abdou14
-- login: esrefzeki
-  count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/54935247?u=193cf5a169ca05fc54995a4dceabc82c7dc6e5ea&v=4
-  url: https://github.com/esrefzeki
+  avatarUrl: https://avatars.githubusercontent.com/u/38995330?u=5799be795fc310f75f3a5fe9242307d59b194520&v=4
+  url: https://github.com/danielfcollier
 top_contributors:
 - login: waynerv
   count: 25
@@ -240,31 +224,31 @@ top_contributors:
   avatarUrl: https://avatars.githubusercontent.com/u/41147016?u=55010621aece725aa702270b54fed829b6a1fe60&v=4
   url: https://github.com/tokusumi
 - login: Kludex
-  count: 20
+  count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: jaystone776
-  count: 17
+  count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/11191137?u=299205a95e9b6817a43144a48b643346a5aac5cc&v=4
   url: https://github.com/jaystone776
 - login: dmontagu
-  count: 16
+  count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
+- login: Xewus
+  count: 14
+  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
+  url: https://github.com/Xewus
 - login: euri10
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
   url: https://github.com/euri10
-- login: Xewus
-  count: 13
-  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
-  url: https://github.com/Xewus
 - login: mariacamilagl
   count: 12
   avatarUrl: https://avatars.githubusercontent.com/u/11489395?u=4adb6986bf3debfc2b8216ae701f2bd47d73da7d&v=4
   url: https://github.com/mariacamilagl
 - login: Smlep
-  count: 10
+  count: 11
   avatarUrl: https://avatars.githubusercontent.com/u/16785985?v=4
   url: https://github.com/Smlep
 - login: Serrones
@@ -287,6 +271,10 @@ top_contributors:
   count: 7
   avatarUrl: https://avatars.githubusercontent.com/u/119126536?u=9fc0d48f3307817bafecc5861eb2168401a6cb04&v=4
   url: https://github.com/Alexandrhub
+- login: NinaHwang
+  count: 6
+  avatarUrl: https://avatars.githubusercontent.com/u/79563565?u=eee6bfe9224c71193025ab7477f4f96ceaa05c62&v=4
+  url: https://github.com/NinaHwang
 - login: batlopes
   count: 6
   avatarUrl: https://avatars.githubusercontent.com/u/33462923?u=0fb3d7acb316764616f11e4947faf080e49ad8d9&v=4
@@ -297,7 +285,7 @@ top_contributors:
   url: https://github.com/wshayes
 - login: samuelcolvin
   count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=807390ba9cfe23906c3bf8a0d56aaca3cf2bfa0d&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4
   url: https://github.com/samuelcolvin
 - login: SwftAlpc
   count: 5
@@ -311,10 +299,10 @@ top_contributors:
   count: 5
   avatarUrl: https://avatars.githubusercontent.com/u/43503750?u=f440bc9062afb3c43b9b9c6cdfdcfe31d58699ef&v=4
   url: https://github.com/ComicShrimp
-- login: NinaHwang
+- login: tamtam-fitness
   count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/79563565?u=eee6bfe9224c71193025ab7477f4f96ceaa05c62&v=4
-  url: https://github.com/NinaHwang
+  avatarUrl: https://avatars.githubusercontent.com/u/62091034?u=8da19a6bd3d02f5d6ba30c7247d5b46c98dd1403&v=4
+  url: https://github.com/tamtam-fitness
 - login: jekirl
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/2546697?u=a027452387d85bd4a14834e19d716c99255fb3b7&v=4
@@ -335,10 +323,18 @@ top_contributors:
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/3360631?u=5fa1f475ad784d64eb9666bdd43cc4d285dcc773&v=4
   url: https://github.com/hitrust
+- login: JulianMaurin
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/63545168?u=b7d15ac865268cbefc2d739e2f23d9aeeac1a622&v=4
+  url: https://github.com/JulianMaurin
 - login: lsglucas
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/61513630?u=320e43fe4dc7bc6efc64e9b8f325f8075634fd20&v=4
   url: https://github.com/lsglucas
+- login: iudeen
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
 - login: axel584
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
@@ -347,19 +343,27 @@ top_contributors:
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/36765187?u=c6e0ba571c1ccb6db9d94e62e4b8b5eda811a870&v=4
   url: https://github.com/ivan-abc
+- login: rostik1410
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/11443899?u=e26a635c2ba220467b308a326a579b8ccf4a8701&v=4
+  url: https://github.com/rostik1410
 top_reviewers:
 - login: Kludex
-  count: 122
+  count: 139
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
+- login: yezz123
+  count: 80
+  avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
+  url: https://github.com/yezz123
 - login: BilalAlpaslan
   count: 79
   avatarUrl: https://avatars.githubusercontent.com/u/47563997?u=63ed66e304fe8d765762c70587d61d9196e5c82d&v=4
   url: https://github.com/BilalAlpaslan
-- login: yezz123
-  count: 77
-  avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
-  url: https://github.com/yezz123
+- login: iudeen
+  count: 54
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
 - login: tokusumi
   count: 51
   avatarUrl: https://avatars.githubusercontent.com/u/41147016?u=55010621aece725aa702270b54fed829b6a1fe60&v=4
@@ -376,18 +380,14 @@ top_reviewers:
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/62724709?u=bba5af018423a2858d49309bed2a899bb5c34ac5&v=4
   url: https://github.com/ycd
-- login: iudeen
+- login: Xewus
   count: 44
-  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
-  url: https://github.com/iudeen
+  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
+  url: https://github.com/Xewus
 - login: cikay
   count: 41
   avatarUrl: https://avatars.githubusercontent.com/u/24587499?u=e772190a051ab0eaa9c8542fcff1892471638f2b&v=4
   url: https://github.com/cikay
-- login: Xewus
-  count: 35
-  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
-  url: https://github.com/Xewus
 - login: JarroVGIT
   count: 34
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
@@ -412,6 +412,10 @@ top_reviewers:
   count: 26
   avatarUrl: https://avatars.githubusercontent.com/u/61513630?u=320e43fe4dc7bc6efc64e9b8f325f8075634fd20&v=4
   url: https://github.com/lsglucas
+- login: LorhanSohaky
+  count: 24
+  avatarUrl: https://avatars.githubusercontent.com/u/16273730?u=095b66f243a2cd6a0aadba9a095009f8aaf18393&v=4
+  url: https://github.com/LorhanSohaky
 - login: Ryandaydev
   count: 24
   avatarUrl: https://avatars.githubusercontent.com/u/4292423?u=809f3d1074d04bbc28012a7f17f06ea56f5bd71a&v=4
@@ -420,10 +424,6 @@ top_reviewers:
   count: 23
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
-- login: LorhanSohaky
-  count: 23
-  avatarUrl: https://avatars.githubusercontent.com/u/16273730?u=095b66f243a2cd6a0aadba9a095009f8aaf18393&v=4
-  url: https://github.com/LorhanSohaky
 - login: rjNemo
   count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/56785022?u=d5c3a02567c8649e146fcfc51b6060ccaf8adef8&v=4
@@ -434,7 +434,7 @@ top_reviewers:
   url: https://github.com/hard-coders
 - login: odiseo0
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=2da05dab6cc8e1ade557801634760a56e4101796&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
   url: https://github.com/odiseo0
 - login: 0417taehyun
   count: 19
@@ -456,6 +456,14 @@ top_reviewers:
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/52768429?u=6a3aa15277406520ad37f6236e89466ed44bc5b8&v=4
   url: https://github.com/SwftAlpc
+- login: axel584
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
+  url: https://github.com/axel584
+- login: Alexandrhub
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/119126536?u=9fc0d48f3307817bafecc5861eb2168401a6cb04&v=4
+  url: https://github.com/Alexandrhub
 - login: DevDae
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/87962045?u=08e10fa516e844934f4b3fc7c38b33c61697e4a1&v=4
@@ -468,18 +476,18 @@ top_reviewers:
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/63476957?u=6c86e59b48e0394d4db230f37fc9ad4d7e2c27c7&v=4
   url: https://github.com/delhi09
-- login: Alexandrhub
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/119126536?u=9fc0d48f3307817bafecc5861eb2168401a6cb04&v=4
-  url: https://github.com/Alexandrhub
 - login: sh0nk
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/6478810?u=af15d724875cec682ed8088a86d36b2798f981c0&v=4
   url: https://github.com/sh0nk
 - login: peidrao
   count: 13
-  avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=5b94b548ef0002ef3219d7c07ac0fac17c6201a2&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=a66902b40c13647d0ed0e573d598128240a4dd04&v=4
   url: https://github.com/peidrao
+- login: wdh99
+  count: 13
+  avatarUrl: https://avatars.githubusercontent.com/u/108172295?u=8a8fb95d5afe3e0fa33257b2aecae88d436249eb&v=4
+  url: https://github.com/wdh99
 - login: r0b2g1t
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/5357541?u=6428442d875d5d71aaa1bb38bb11c4be1a526bc2&v=4
@@ -488,10 +496,6 @@ top_reviewers:
   count: 12
   avatarUrl: https://avatars.githubusercontent.com/u/31848542?u=494ecc298e3f26197495bb357ad0f57cfd5f7a32&v=4
   url: https://github.com/RunningIkkyu
-- login: axel584
-  count: 12
-  avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
-  url: https://github.com/axel584
 - login: ivan-abc
   count: 12
   avatarUrl: https://avatars.githubusercontent.com/u/36765187?u=c6e0ba571c1ccb6db9d94e62e4b8b5eda811a870&v=4
@@ -540,7 +544,3 @@ top_reviewers:
   count: 9
   avatarUrl: https://avatars.githubusercontent.com/u/69092910?u=4ac58eab99bd37d663f3d23551df96d4fbdbf760&v=4
   url: https://github.com/bezaca
-- login: oandersonmagalhaes
-  count: 9
-  avatarUrl: https://avatars.githubusercontent.com/u/83456692?v=4
-  url: https://github.com/oandersonmagalhaes
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 1b5240b5e..dac47d2f0 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -5,6 +5,15 @@ gold:
   - url: https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023
     title: "Build, run and scale your apps on a modern, reliable, and secure PaaS."
     img: https://fastapi.tiangolo.com/img/sponsors/platform-sh.png
+  - url: https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge
+    title: Fern | SDKs and API docs
+    img: https://fastapi.tiangolo.com/img/sponsors/fern.svg
+  - url: https://www.porter.run
+    title: Deploy FastAPI on AWS with a few clicks
+    img: https://fastapi.tiangolo.com/img/sponsors/porter.png
+  - url: https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor
+    title: Automate FastAPI documentation generation with Bump.sh
+    img: https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
@@ -21,16 +30,19 @@ silver:
   - url: https://careers.powens.com/
     title: Powens is hiring!
     img: https://fastapi.tiangolo.com/img/sponsors/powens.png
-  - url: https://www.svix.com/
-    title: Svix - Webhooks as a service
-    img: https://fastapi.tiangolo.com/img/sponsors/svix.svg
   - url: https://databento.com/
     title: Pay as you go for market data
     img: https://fastapi.tiangolo.com/img/sponsors/databento.svg
+  - url: https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship
+    title: SDKs for your API | Speakeasy
+    img: https://fastapi.tiangolo.com/img/sponsors/speakeasy.png
+  - url: https://www.svix.com/
+    title: Svix - Webhooks as a service
+    img: https://fastapi.tiangolo.com/img/sponsors/svix.svg
 bronze:
   - url: https://www.exoflare.com/open-source/?utm_source=FastAPI&utm_campaign=open_source
     title: Biosecurity risk assessments made easy.
     img: https://fastapi.tiangolo.com/img/sponsors/exoflare.png
-  - url: https://www.flint.sh
-    title: IT expertise, consulting and development by passionate people
-    img: https://fastapi.tiangolo.com/img/sponsors/flint.png
+  - url: https://bit.ly/3JJ7y5C
+    title: Build cross-modal and multimodal applications on the cloud
+    img: https://fastapi.tiangolo.com/img/sponsors/jina2.svg
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index b3cb06327..acbcc2205 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -12,8 +12,12 @@ logins:
   - ObliviousAI
   - Doist
   - nihpo
-  - svix
   - armand-sauzay
   - databento-bot
+  - databento
   - nanram22
   - Flint-company
+  - porter-dev
+  - fern-api
+  - ndimares
+  - svixhq
diff --git a/docs/en/docs/about/index.md b/docs/en/docs/about/index.md
new file mode 100644
index 000000000..27b78696b
--- /dev/null
+++ b/docs/en/docs/about/index.md
@@ -0,0 +1,3 @@
+# About
+
+About FastAPI, its design, inspiration and more. 🤓
diff --git a/docs/en/docs/advanced/additional-status-codes.md b/docs/en/docs/advanced/additional-status-codes.md
index 416444d3b..0ce275343 100644
--- a/docs/en/docs/advanced/additional-status-codes.md
+++ b/docs/en/docs/advanced/additional-status-codes.md
@@ -26,7 +26,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
     {!> ../../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  26"
     {!> ../../../docs_src/additional_status_codes/tutorial001_an.py!}
@@ -41,7 +41,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
     {!> ../../../docs_src/additional_status_codes/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/advanced-dependencies.md b/docs/en/docs/advanced/advanced-dependencies.md
index 402c5d755..0cffab56d 100644
--- a/docs/en/docs/advanced/advanced-dependencies.md
+++ b/docs/en/docs/advanced/advanced-dependencies.md
@@ -24,13 +24,13 @@ To do that, we declare a method `__call__`:
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -51,13 +51,13 @@ And now, we can use `__init__` to declare the parameters of the instance that we
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -78,13 +78,13 @@ We could create an instance of this class with:
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -113,13 +113,13 @@ checker(q="somequery")
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/extending-openapi.md b/docs/en/docs/advanced/extending-openapi.md
deleted file mode 100644
index bec184dee..000000000
--- a/docs/en/docs/advanced/extending-openapi.md
+++ /dev/null
@@ -1,318 +0,0 @@
-# Extending OpenAPI
-
-!!! warning
-    This is a rather advanced feature. You probably can skip it.
-
-    If you are just following the tutorial - user guide, you can probably skip this section.
-
-    If you already know that you need to modify the generated OpenAPI schema, continue reading.
-
-There are some cases where you might need to modify the generated OpenAPI schema.
-
-In this section you will see how.
-
-## The normal process
-
-The normal (default) process, is as follows.
-
-A `FastAPI` application (instance) has an `.openapi()` method that is expected to return the OpenAPI schema.
-
-As part of the application object creation, a *path operation* for `/openapi.json` (or for whatever you set your `openapi_url`) is registered.
-
-It just returns a JSON response with the result of the application's `.openapi()` method.
-
-By default, what the method `.openapi()` does is check the property `.openapi_schema` to see if it has contents and return them.
-
-If it doesn't, it generates them using the utility function at `fastapi.openapi.utils.get_openapi`.
-
-And that function `get_openapi()` receives as parameters:
-
-* `title`: The OpenAPI title, shown in the docs.
-* `version`: The version of your API, e.g. `2.5.0`.
-* `openapi_version`: The version of the OpenAPI specification used. By default, the latest: `3.1.0`.
-* `summary`: A short summary of the API.
-* `description`: The description of your API, this can include markdown and will be shown in the docs.
-* `routes`: A list of routes, these are each of the registered *path operations*. They are taken from `app.routes`.
-
-!!! info
-    The parameter `summary` is available in OpenAPI 3.1.0 and above, supported by FastAPI 0.99.0 and above.
-
-## Overriding the defaults
-
-Using the information above, you can use the same utility function to generate the OpenAPI schema and override each part that you need.
-
-For example, let's add <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">ReDoc's OpenAPI extension to include a custom logo</a>.
-
-### Normal **FastAPI**
-
-First, write all your **FastAPI** application as normally:
-
-```Python hl_lines="1  4  7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Generate the OpenAPI schema
-
-Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
-
-```Python hl_lines="2  15-21"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Modify the OpenAPI schema
-
-Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
-
-```Python hl_lines="22-24"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Cache the OpenAPI schema
-
-You can use the property `.openapi_schema` as a "cache", to store your generated schema.
-
-That way, your application won't have to generate the schema every time a user opens your API docs.
-
-It will be generated only once, and then the same cached schema will be used for the next requests.
-
-```Python hl_lines="13-14  25-26"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Override the method
-
-Now you can replace the `.openapi()` method with your new function.
-
-```Python hl_lines="29"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Check it
-
-Once you go to <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> you will see that you are using your custom logo (in this example, **FastAPI**'s logo):
-
-<img src="/img/tutorial/extending-openapi/image01.png">
-
-## Self-hosting JavaScript and CSS for docs
-
-The API docs use **Swagger UI** and **ReDoc**, and each of those need some JavaScript and CSS files.
-
-By default, those files are served from a <abbr title="Content Delivery Network: A service, normally composed of several servers, that provides static files, like JavaScript and CSS. It's commonly used to serve those files from the server closer to the client, improving performance.">CDN</abbr>.
-
-But it's possible to customize it, you can set a specific CDN, or serve the files yourself.
-
-That's useful, for example, if you need your app to keep working even while offline, without open Internet access, or in a local network.
-
-Here you'll see how to serve those files yourself, in the same FastAPI app, and configure the docs to use them.
-
-### Project file structure
-
-Let's say your project file structure looks like this:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-```
-
-Now create a directory to store those static files.
-
-Your new file structure could look like this:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static/
-```
-
-### Download the files
-
-Download the static files needed for the docs and put them on that `static/` directory.
-
-You can probably right-click each link and select an option similar to `Save link as...`.
-
-**Swagger UI** uses the files:
-
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
-
-And **ReDoc** uses the file:
-
-* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
-
-After that, your file structure could look like:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static
-    ├── redoc.standalone.js
-    ├── swagger-ui-bundle.js
-    └── swagger-ui.css
-```
-
-### Serve the static files
-
-* Import `StaticFiles`.
-* "Mount" a `StaticFiles()` instance in a specific path.
-
-```Python hl_lines="7  11"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### Test the static files
-
-Start your application and go to <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
-
-You should see a very long JavaScript file for **ReDoc**.
-
-It could start with something like:
-
-```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- *   Version: "2.0.0-rc.18"
- *   Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
-...
-```
-
-That confirms that you are being able to serve static files from your app, and that you placed the static files for the docs in the correct place.
-
-Now we can configure the app to use those static files for the docs.
-
-### Disable the automatic docs
-
-The first step is to disable the automatic docs, as those use the CDN by default.
-
-To disable them, set their URLs to `None` when creating your `FastAPI` app:
-
-```Python hl_lines="9"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### Include the custom docs
-
-Now you can create the *path operations* for the custom docs.
-
-You can re-use FastAPI's internal functions to create the HTML pages for the docs, and pass them the needed arguments:
-
-* `openapi_url`: the URL where the HTML page for the docs can get the OpenAPI schema for your API. You can use here the attribute `app.openapi_url`.
-* `title`: the title of your API.
-* `oauth2_redirect_url`: you can use `app.swagger_ui_oauth2_redirect_url` here to use the default.
-* `swagger_js_url`: the URL where the HTML for your Swagger UI docs can get the **JavaScript** file. This is the one that your own app is now serving.
-* `swagger_css_url`: the URL where the HTML for your Swagger UI docs can get the **CSS** file. This is the one that your own app is now serving.
-
-And similarly for ReDoc...
-
-```Python hl_lines="2-6  14-22  25-27  30-36"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-!!! tip
-    The *path operation* for `swagger_ui_redirect` is a helper for when you use OAuth2.
-
-    If you integrate your API with an OAuth2 provider, you will be able to authenticate and come back to the API docs with the acquired credentials. And interact with it using the real OAuth2 authentication.
-
-    Swagger UI will handle it behind the scenes for you, but it needs this "redirect" helper.
-
-### Create a *path operation* to test it
-
-Now, to be able to test that everything works, create a *path operation*:
-
-```Python hl_lines="39-41"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### Test it
-
-Now, you should be able to disconnect your WiFi, go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page.
-
-And even without Internet, you would be able to see the docs for your API and interact with it.
-
-## Configuring Swagger UI
-
-You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI parameters</a>.
-
-To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.
-
-`swagger_ui_parameters` receives a dictionary with the configurations passed to Swagger UI directly.
-
-FastAPI converts the configurations to **JSON** to make them compatible with JavaScript, as that's what Swagger UI needs.
-
-### Disable Syntax Highlighting
-
-For example, you could disable syntax highlighting in Swagger UI.
-
-Without changing the settings, syntax highlighting is enabled by default:
-
-<img src="/img/tutorial/extending-openapi/image02.png">
-
-But you can disable it by setting `syntaxHighlight` to `False`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial003.py!}
-```
-
-...and then Swagger UI won't show the syntax highlighting anymore:
-
-<img src="/img/tutorial/extending-openapi/image03.png">
-
-### Change the Theme
-
-The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial004.py!}
-```
-
-That configuration would change the syntax highlighting color theme:
-
-<img src="/img/tutorial/extending-openapi/image04.png">
-
-### Change Default Swagger UI Parameters
-
-FastAPI includes some default configuration parameters appropriate for most of the use cases.
-
-It includes these default configurations:
-
-```Python
-{!../../../fastapi/openapi/docs.py[ln:7-13]!}
-```
-
-You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
-
-For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial005.py!}
-```
-
-### Other Swagger UI Parameters
-
-To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
-
-### JavaScript-only settings
-
-Swagger UI also allows other configurations to be **JavaScript-only** objects (for example, JavaScript functions).
-
-FastAPI also includes these JavaScript-only `presets` settings:
-
-```JavaScript
-presets: [
-    SwaggerUIBundle.presets.apis,
-    SwaggerUIBundle.SwaggerUIStandalonePreset
-]
-```
-
-These are **JavaScript** objects, not strings, so you can't pass them from Python code directly.
-
-If you need to use JavaScript-only configurations like those, you can use one of the methods above. Override all the Swagger UI *path operation* and manually write any JavaScript you need.
diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index f62c0b57c..07a8f039f 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -12,6 +12,19 @@ A common tool is <a href="https://openapi-generator.tech/" class="external-link"
 
 If you are building a **frontend**, a very interesting alternative is <a href="https://github.com/ferdikoomen/openapi-typescript-codegen" class="external-link" target="_blank">openapi-typescript-codegen</a>.
 
+## Client and SDK Generators - Sponsor
+
+There are also some **company-backed** Client and SDK generators based on OpenAPI (FastAPI), in some cases they can offer you **additional features** on top of high-quality generated SDKs/clients.
+
+Some of them also ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**.
+
+And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
+
+You might want to try their services and follow their guides:
+
+* <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a>
+* <a href="https://speakeasyapi.dev/?utm_source=fastapi+repo&utm_medium=github+sponsorship" class="external-link" target="_blank">Speakeasy</a>
+
 ## Generate a TypeScript Frontend Client
 
 Let's start with a simple FastAPI application:
@@ -22,7 +35,7 @@ Let's start with a simple FastAPI application:
     {!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11  14-15  18  19  23"
     {!> ../../../docs_src/generate_clients/tutorial001.py!}
@@ -134,7 +147,7 @@ For example, you could have a section for **items** and another section for **us
     {!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23  28  36"
     {!> ../../../docs_src/generate_clients/tutorial002.py!}
@@ -191,7 +204,7 @@ You can then pass that custom function to **FastAPI** as the `generate_unique_id
     {!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8-9  12"
     {!> ../../../docs_src/generate_clients/tutorial003.py!}
diff --git a/docs/en/docs/advanced/index.md b/docs/en/docs/advanced/index.md
index 467f0833e..d8dcd4ca6 100644
--- a/docs/en/docs/advanced/index.md
+++ b/docs/en/docs/advanced/index.md
@@ -17,8 +17,17 @@ You could still use most of the features in **FastAPI** with the knowledge from
 
 And the next sections assume you already read it, and assume that you know those main ideas.
 
-## TestDriven.io course
+## External Courses
 
-If you would like to take an advanced-beginner course to complement this section of the docs, you might want to check: <a href="https://testdriven.io/courses/tdd-fastapi/" class="external-link" target="_blank">Test-Driven Development with FastAPI and Docker</a> by **TestDriven.io**.
+Although the [Tutorial - User Guide](../tutorial/){.internal-link target=_blank} and this **Advanced User Guide** are written as a guided tutorial (like a book) and should be enough for you to **learn FastAPI**, you might want to complement it with additional courses.
 
-They are currently donating 10% of all profits to the development of **FastAPI**. 🎉 😄
+Or it might be the case that you just prefer to take other courses because they adapt better to your learning style.
+
+Some course providers ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**.
+
+And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good learning experience** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
+
+You might want to try their courses:
+
+* <a href="https://training.talkpython.fm/fastapi-courses" class="external-link" target="_blank">Talk Python Training</a>
+* <a href="https://testdriven.io/courses/tdd-fastapi/" class="external-link" target="_blank">Test-Driven Development</a>
diff --git a/docs/en/docs/advanced/security/http-basic-auth.md b/docs/en/docs/advanced/security/http-basic-auth.md
index 8177a4b28..6f9002f60 100644
--- a/docs/en/docs/advanced/security/http-basic-auth.md
+++ b/docs/en/docs/advanced/security/http-basic-auth.md
@@ -26,13 +26,13 @@ Then, when you type that username and password, the browser sends them in the he
     {!> ../../../docs_src/security/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  7  11"
     {!> ../../../docs_src/security/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -65,13 +65,13 @@ Then we can use `secrets.compare_digest()` to ensure that `credentials.username`
     {!> ../../../docs_src/security/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  12-24"
     {!> ../../../docs_src/security/tutorial007_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -148,13 +148,13 @@ After detecting that the credentials are incorrect, return an `HTTPException` wi
     {!> ../../../docs_src/security/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="26-30"
     {!> ../../../docs_src/security/tutorial007_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index 41cd61683..304a46090 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -68,7 +68,7 @@ First, let's quickly see the parts that change from the examples in the main **T
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  4  8  12  47  65  106  108-116  122-125  129-135  140  156"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -92,7 +92,7 @@ First, let's quickly see the parts that change from the examples in the main **T
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -121,7 +121,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="63-66"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -146,7 +146,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -188,7 +188,7 @@ And we return the scopes as part of the JWT token.
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="156"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -212,7 +212,7 @@ And we return the scopes as part of the JWT token.
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -254,7 +254,7 @@ In this case, it requires the scope `me` (it could require more than one scope).
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  140  171"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -278,7 +278,7 @@ In this case, it requires the scope `me` (it could require more than one scope).
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -320,7 +320,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  106"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -344,7 +344,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -377,7 +377,7 @@ In this exception, we include the scopes required (if any) as a string separated
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="106  108-116"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -401,7 +401,7 @@ In this exception, we include the scopes required (if any) as a string separated
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -436,7 +436,7 @@ We also verify that we have a user with that username, and if not, we raise that
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="47  117-128"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -460,7 +460,7 @@ We also verify that we have a user with that username, and if not, we raise that
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -487,7 +487,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="129-135"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -511,7 +511,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index 8f6c7da93..f6db8d2b1 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -260,13 +260,13 @@ Now we create a dependency that returns a new `config.Settings()`.
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="6  12-13"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -276,7 +276,7 @@ Now we create a dependency that returns a new `config.Settings()`.
     ```
 
 !!! tip
-    We'll discuss the `@lru_cache()` in a bit.
+    We'll discuss the `@lru_cache` in a bit.
 
     For now you can assume `get_settings()` is a normal function.
 
@@ -288,13 +288,13 @@ And then we can require it from the *path operation function* as a dependency an
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  19-21"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -326,7 +326,7 @@ This practice is common enough that it has a name, these environment variables a
 
     But a dotenv file doesn't really have to have that exact filename.
 
-Pydantic has support for reading from these types of files using an external library. You can read more at <a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>.
+Pydantic has support for reading from these types of files using an external library. You can read more at <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>.
 
 !!! tip
     For this to work, you need to `pip install python-dotenv`.
@@ -388,7 +388,7 @@ def get_settings():
 
 we would create that object for each request, and we would be reading the `.env` file for each request. ⚠️
 
-But as we are using the `@lru_cache()` decorator on top, the `Settings` object will be created only once, the first time it's called. ✔️
+But as we are using the `@lru_cache` decorator on top, the `Settings` object will be created only once, the first time it's called. ✔️
 
 === "Python 3.9+"
 
@@ -396,13 +396,13 @@ But as we are using the `@lru_cache()` decorator on top, the `Settings` object w
     {!> ../../../docs_src/settings/app03_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  11"
     {!> ../../../docs_src/settings/app03_an/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -415,14 +415,14 @@ Then for any subsequent calls of `get_settings()` in the dependencies for the ne
 
 #### `lru_cache` Technical Details
 
-`@lru_cache()` modifies the function it decorates to return the same value that was returned the first time, instead of computing it again, executing the code of the function every time.
+`@lru_cache` modifies the function it decorates to return the same value that was returned the first time, instead of computing it again, executing the code of the function every time.
 
 So, the function below it will be executed once for each combination of arguments. And then the values returned by each of those combinations of arguments will be used again and again whenever the function is called with exactly the same combination of arguments.
 
 For example, if you have a function:
 
 ```Python
-@lru_cache()
+@lru_cache
 def say_hi(name: str, salutation: str = "Ms."):
     return f"Hello {salutation} {name}"
 ```
@@ -474,7 +474,7 @@ In the case of our dependency `get_settings()`, the function doesn't even take a
 
 That way, it behaves almost as if it was just a global variable. But as it uses a dependency function, then we can override it easily for testing.
 
-`@lru_cache()` is part of `functools` which is part of Python's standard library, you can read more about it in the <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python docs for `@lru_cache()`</a>.
+`@lru_cache` is part of `functools` which is part of Python's standard library, you can read more about it in the <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python docs for `@lru_cache`</a>.
 
 ## Recap
 
@@ -482,4 +482,4 @@ You can use Pydantic Settings to handle the settings or configurations for your
 
 * By using a dependency you can simplify testing.
 * You can use `.env` files with it.
-* Using `@lru_cache()` lets you avoid reading the dotenv file again and again for each request, while allowing you to override it during testing.
+* Using `@lru_cache` lets you avoid reading the dotenv file again and again for each request, while allowing you to override it during testing.
diff --git a/docs/en/docs/advanced/testing-dependencies.md b/docs/en/docs/advanced/testing-dependencies.md
index ee48a735d..57dd87f56 100644
--- a/docs/en/docs/advanced/testing-dependencies.md
+++ b/docs/en/docs/advanced/testing-dependencies.md
@@ -40,7 +40,7 @@ And then **FastAPI** will call that override instead of the original dependency.
     {!> ../../../docs_src/dependency_testing/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="29-30  33"
     {!> ../../../docs_src/dependency_testing/tutorial001_an.py!}
@@ -55,7 +55,7 @@ And then **FastAPI** will call that override instead of the original dependency.
     {!> ../../../docs_src/dependency_testing/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/websockets.md b/docs/en/docs/advanced/websockets.md
index 94cf191d2..49b8fba89 100644
--- a/docs/en/docs/advanced/websockets.md
+++ b/docs/en/docs/advanced/websockets.md
@@ -124,7 +124,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
     {!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="69-70  83"
     {!> ../../../docs_src/websockets/tutorial002_an.py!}
@@ -139,7 +139,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
     {!> ../../../docs_src/websockets/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -191,7 +191,7 @@ When a WebSocket connection is closed, the `await websocket.receive_text()` will
     {!> ../../../docs_src/websockets/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="81-83"
     {!> ../../../docs_src/websockets/tutorial003.py!}
diff --git a/docs/en/docs/alternatives.md b/docs/en/docs/alternatives.md
index 0f074ccf3..a777ddb98 100644
--- a/docs/en/docs/alternatives.md
+++ b/docs/en/docs/alternatives.md
@@ -119,6 +119,8 @@ That's why when talking about version 2.0 it's common to say "Swagger", and for
 
     These two were chosen for being fairly popular and stable, but doing a quick search, you could find dozens of additional alternative user interfaces for OpenAPI (that you can use with **FastAPI**).
 
+    For example, you could try <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-alternatives" class="external-link" target="_blank">Fern</a> which is also a FastAPI sponsor. 😎🎉
+
 ### Flask REST frameworks
 
 There are several Flask REST frameworks, but after investing the time and work into investigating them, I found that many are discontinued or abandoned, with several standing issues that made them unfit.
diff --git a/docs/en/docs/async.md b/docs/en/docs/async.md
index 3d4b1956a..2ead1f2db 100644
--- a/docs/en/docs/async.md
+++ b/docs/en/docs/async.md
@@ -409,11 +409,11 @@ Still, in both situations, chances are that **FastAPI** will [still be faster](/
 
 ### Dependencies
 
-The same applies for [dependencies](/tutorial/dependencies/index.md){.internal-link target=_blank}. If a dependency is a standard `def` function instead of `async def`, it is run in the external threadpool.
+The same applies for [dependencies](./tutorial/dependencies/index.md){.internal-link target=_blank}. If a dependency is a standard `def` function instead of `async def`, it is run in the external threadpool.
 
 ### Sub-dependencies
 
-You can have multiple dependencies and [sub-dependencies](/tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} requiring each other (as parameters of the function definitions), some of them might be created with `async def` and some with normal `def`. It would still work, and the ones created with normal `def` would be called on an external thread (from the threadpool) instead of being "awaited".
+You can have multiple dependencies and [sub-dependencies](./tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} requiring each other (as parameters of the function definitions), some of them might be created with `async def` and some with normal `def`. It would still work, and the ones created with normal `def` would be called on an external thread (from the threadpool) instead of being "awaited".
 
 ### Other utility functions
 
diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index f968489ae..cfdb607d7 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -126,7 +126,7 @@ And if you update that local FastAPI source code when you run that Python file a
 That way, you don't have to "install" your local version to be able to test every change.
 
 !!! note "Technical Details"
-    This only happens when you install using this included `requiements.txt` instead of installing `pip install fastapi` directly.
+    This only happens when you install using this included `requirements.txt` instead of installing `pip install fastapi` directly.
 
     That is because inside of the `requirements.txt` file, the local version of FastAPI is marked to be installed in "editable" mode, with the `-e` option.
 
diff --git a/docs/en/docs/css/custom.css b/docs/en/docs/css/custom.css
index 066b51725..187040792 100644
--- a/docs/en/docs/css/custom.css
+++ b/docs/en/docs/css/custom.css
@@ -144,3 +144,39 @@ code {
   margin-top: 2em;
   margin-bottom: 2em;
 }
+
+/* Screenshots */
+/*
+Simulate a browser window frame.
+Inspired by Termynal's CSS tricks with modifications
+*/
+
+.screenshot {
+  display: block;
+  background-color: #d3e0de;
+  border-radius: 4px;
+  padding: 45px 5px 5px;
+  position: relative;
+  -webkit-box-sizing: border-box;
+          box-sizing: border-box;
+}
+
+.screenshot img {
+  display: block;
+  border-radius: 2px;
+}
+
+.screenshot:before {
+  content: '';
+  position: absolute;
+  top: 15px;
+  left: 15px;
+  display: inline-block;
+  width: 15px;
+  height: 15px;
+  border-radius: 50%;
+  /* A little hack to display the window buttons in one pseudo element. */
+  background: #d9515d;
+  -webkit-box-shadow: 25px 0 0 #f4c025, 50px 0 0 #3ec930;
+          box-shadow: 25px 0 0 #f4c025, 50px 0 0 #3ec930;
+}
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
new file mode 100644
index 000000000..b2836aeb4
--- /dev/null
+++ b/docs/en/docs/deployment/cloud.md
@@ -0,0 +1,17 @@
+# Deploy FastAPI on Cloud Providers
+
+You can use virtually **any cloud provider** to deploy your FastAPI application.
+
+In most of the cases, the main cloud providers have guides to deploy FastAPI with them.
+
+## Cloud Providers - Sponsors
+
+Some cloud providers ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**.
+
+And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
+
+You might want to try their services and follow their guides:
+
+* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
+* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
+* <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a>
diff --git a/docs/en/docs/deployment/deta.md b/docs/en/docs/deployment/deta.md
deleted file mode 100644
index 229d7fd5d..000000000
--- a/docs/en/docs/deployment/deta.md
+++ /dev/null
@@ -1,391 +0,0 @@
-# Deploy FastAPI on Deta Space
-
-In this section you will learn how to easily deploy a **FastAPI** application on <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Deta Space</a>, for free. 🎁
-
-It will take you about **10 minutes** to deploy an API that you can use. After that, you can optionally release it to anyone.
-
-Let's dive in.
-
-!!! info
-    <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Deta</a> is a **FastAPI** sponsor. 🎉
-
-## A simple **FastAPI** app
-
-* To start, create an empty directory with the name of your app, for example `./fastapi-deta/`, and then navigate into it.
-
-```console
-$ mkdir fastapi-deta
-$ cd fastapi-deta
-```
-
-### FastAPI code
-
-* Create a `main.py` file with:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Requirements
-
-Now, in the same directory create a file `requirements.txt` with:
-
-```text
-fastapi
-uvicorn[standard]
-```
-
-### Directory structure
-
-You will now have a directory `./fastapi-deta/` with two files:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Create a free **Deta Space** account
-
-Next, create a free account on <a href="https://deta.space/signup?dev_mode=true&ref=fastapi" class="external-link" target="_blank">Deta Space</a>, you just need an email and password.
-
-You don't even need a credit card, but make sure **Developer Mode** is enabled when you sign up.
-
-
-## Install the CLI
-
-Once you have your account, install the Deta Space <abbr title="Command Line Interface application">CLI</abbr>:
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/space-cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/space-cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-After installing it, open a new terminal so that the installed CLI is detected.
-
-In a new terminal, confirm that it was correctly installed with:
-
-<div class="termy">
-
-```console
-$ space --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://deta.space/docs
-
-Usage:
-  space [flags]
-  space [command]
-
-Available Commands:
-  help        Help about any command
-  link        link code to project
-  login       login to space
-  new         create new project
-  push        push code for project
-  release     create release for a project
-  validate    validate spacefile in dir
-  version     Space CLI version
-...
-```
-
-</div>
-
-!!! tip
-    If you have problems installing the CLI, check the official <a href="https://deta.space/docs/en/basics/cli?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a>.
-
-## Login with the CLI
-
-In order to authenticate your CLI with Deta Space, you will need an access token.
-
-To obtain this token, open your <a href="https://deta.space/login?ref=fastapi" class="external-link" target="_blank">Deta Space Canvas</a>, open the **Teletype** (command bar at the bottom of the Canvas), and then click on **Settings**. From there, select **Generate Token** and copy the resulting token.
-
-<img src="/img/deployment/deta/image03.png">
-
-Now run `space login` from the Space CLI. Upon pasting the token into the CLI prompt and pressing enter, you should see a confirmation message.
-
-<div class="termy">
-
-```console
-$ space login
-
-To authenticate the Space CLI with your Space account, generate a new access token in your Space settings and paste it below:
-
-# Enter access token (41 chars) >$ *****************************************
-
-👍 Login Successful!
-```
-
-</div>
-
-## Create a new project in Space
-
-Now that you've authenticated with the Space CLI, use it to create a new <a href="https://deta.space/docs/en/basics/projects" class="external-link" target="_blank">Space Project</a>:
-
-```console
-$ space new
-
-# What is your project's name? >$ fastapi-deta
-```
-
-The Space CLI will ask you to name the project, we will call ours `fastapi-deta`.
-
-Then, it will try to automatically detect which framework or language you are using, showing you what it finds. In our case it will identify the Python app with the following message, prompting you to confirm:
-
-```console
-⚙️ No Spacefile found, trying to auto-detect configuration ...
-👇 Deta detected the following configuration:
-
-Micros:
-name: fastapi-deta
- L src: .
- L engine: python3.9
-
-# Do you want to bootstrap "fastapi-deta" with this configuration? (y/n)$ y
-```
-
-After you confirm, your project will be created in Deta Space inside a special app called <a href="https://deta.space/docs/en/basics/projects#projects-in-builder?ref=fastapi" class="external-link" target="_blank">Builder</a>. Builder is a toolbox that helps you to create and manage your apps in Deta Space.
-
-The CLI will also create a `Spacefile` locally in the `fastapi-deta` directory. The <a href="https://deta.space/docs/en/reference/spacefile?ref=fastapi" class="external-link" target="_blank">Spacefile</a> is a configuration file which tells Deta Space how to run your app. The `Spacefile` for your app will be as follows:
-
-```yaml
-v: 0
-micros:
-  - name: fastapi-deta
-    src: .
-    engine: python3.9
-```
-
-It is a `yaml` file, and you can use it to add features like scheduled tasks or modify how your app functions, which we'll do later. To learn more, read <a href="https://deta.space/docs/en/reference/spacefile" class="external-link" target="_blank">the `Spacefile` documentation</a>.
-
-!!! tip
-    The Space CLI will also create a hidden `.space` folder in your local directory to link your local environment with Deta Space. This folder should not be included in your version control and will automatically be added to your `.gitignore` file, if you have initialized a Git repository.
-
-## Define the run command in the Spacefile
-
-The `run` command in the Spacefile tells Space what command should be executed to start your app. In this case it would be `uvicorn main:app`.
-
-```diff
-v: 0
-micros:
-  - name: fastapi-deta
-    src: .
-    engine: python3.9
-+   run: uvicorn main:app
-```
-
-## Deploy to Deta Space
-
-To get your FastAPI live in the cloud, use one more CLI command:
-
-<div class="termy">
-
-```console
-$ space push
-
----> 100%
-
-build complete... created revision: satyr-jvjk
-
-✔ Successfully pushed your code and created a new Revision!
-ℹ Updating your development instance with the latest Revision, it will be available on your Canvas shortly.
-```
-</div>
-
-This command will package your code, upload all the necessary files to Deta Space, and run a remote build of your app, resulting in a **revision**. Whenever you run `space push` successfully, a live instance of your API is automatically updated with the latest revision.
-
-!!! tip
-    You can manage your <a href="https://deta.space/docs/en/basics/revisions#whats-a-revision" class="external-link" target="_blank">revisions</a> by opening your project in the Builder app. The live copy of your API will be visible under the **Develop** tab in Builder.
-
-## Check it
-
-The live instance of your API will also be added automatically to your Canvas (the dashboard) on Deta Space.
-
-<img src="/img/deployment/deta/image04.png">
-
-Click on the new app called `fastapi-deta`, and it will open your API in a new browser tab on a URL like `https://fastapi-deta-gj7ka8.deta.app/`.
-
-You will get a JSON response from your FastAPI app:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-And now you can head over to the `/docs` of your API. For this example, it would be `https://fastapi-deta-gj7ka8.deta.app/docs`.
-
-<img src="/img/deployment/deta/image05.png">
-
-## Enable public access
-
-Deta will handle authentication for your account using cookies. By default, every app or API that you `push` or install to your Space is personal - it's only accessible to you.
-
-But you can also make your API public using the `Spacefile` from earlier.
-
-With a `public_routes` parameter, you can specify which paths of your API should be available to the public.
-
-Set your `public_routes` to `"*"` to open every route of your API to the public:
-
-```yaml
-v: 0
-micros:
-  - name: fastapi-deta
-    src: .
-    engine: python3.9
-    public_routes:
-      - "/*"
-```
-
-Then run `space push` again to update your live API on Deta Space.
-
-Once it deploys, you can share your URL with anyone and they will be able to access your API. 🚀
-
-## HTTPS
-
-Congrats! You deployed your FastAPI app to Deta Space! 🎉 🍰
-
-Also, notice that Deta Space correctly handles HTTPS for you, so you don't have to take care of that and can be sure that your users will have a secure encrypted connection. ✅ 🔒
-
-## Create a release
-
-Space also allows you to publish your API. When you publish it, anyone else can install their own copy of your API, in their own Deta Space cloud.
-
-To do so, run `space release` in the Space CLI to create an **unlisted release**:
-
-<div class="termy">
-
-```console
-$ space release
-
-# Do you want to use the latest revision (buzzard-hczt)? (y/n)$ y
-
-~ Creating a Release with the latest Revision
-
----> 100%
-
-creating release...
-publishing release in edge locations..
-completed...
-released: fastapi-deta-exp-msbu
-https://deta.space/discovery/r/5kjhgyxewkdmtotx
-
- Lift off -- successfully created a new Release!
- Your Release is available globally on 5 Deta Edges
- Anyone can install their own copy of your app.
-```
-</div>
-
-This command publishes your revision as a release and gives you a link. Anyone you give this link to can install your API.
-
-
-You can also make your app publicly discoverable by creating a **listed release** with `space release --listed` in the Space CLI:
-
-<div class="termy">
-
-```console
-$ space release --listed
-
-# Do you want to use the latest revision (buzzard-hczt)? (y/n)$ y
-
-~ Creating a listed Release with the latest Revision ...
-
-creating release...
-publishing release in edge locations..
-completed...
-released: fastapi-deta-exp-msbu
-https://deta.space/discovery/@user/fastapi-deta
-
- Lift off -- successfully created a new Release!
- Your Release is available globally on 5 Deta Edges
- Anyone can install their own copy of your app.
- Listed on Discovery for others to find!
-```
-</div>
-
-This will allow anyone to find and install your app via <a href="https://deta.space/discovery?ref=fastapi" class="external-link" target="_blank">Deta Discovery</a>. Read more about <a href="https://deta.space/docs/en/basics/releases?ref=fastapi" class="external-link" target="_blank">releasing your app in the docs</a>.
-
-## Check runtime logs
-
-Deta Space also lets you inspect the logs of every app you build or install.
-
-Add some logging functionality to your app by adding a `print` statement to your `main.py` file.
-
-```py
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    print(item_id)
-    return {"item_id": item_id}
-```
-
-The code within the `read_item` function includes a print statement that will output the `item_id` that is included in the URL. Send a request to your _path operation_ `/items/{item_id}` from the docs UI (which will have a URL like `https://fastapi-deta-gj7ka8.deta.app/docs`), using an ID like `5` as an example.
-
-Now go to your <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Space's Canvas</a>. Click on the context menu (`...`) of your live app instance, and then click on **View Logs**. Here you can view your app's logs, sorted by time.
-
-<img src="/img/deployment/deta/image06.png">
-
-## Learn more
-
-At some point, you will probably want to store some data for your app in a way that persists through time. For that you can use <a href="https://deta.space/docs/en/basics/data#deta-base?ref=fastapi" class="external-link" target="_blank">Deta Base</a> and <a href="https://deta.space/docs/en/basics/data#deta-drive?ref=fastapi" class="external-link" target="_blank">Deta Drive</a>, both of which have a generous **free tier**.
-
-You can also read more in the <a href="https://deta.space/docs/?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a>.
-
-!!! tip
-    If you have any Deta related questions, comments, or feedback, head to the <a href="https://go.deta.dev/discord" class="external-link" target="_blank">Deta Discord server</a>.
-
-
-## Deployment Concepts
-
-Coming back to the concepts we discussed in [Deployments Concepts](./concepts.md){.internal-link target=_blank}, here's how each of them would be handled with Deta Space:
-
-- **HTTPS**: Handled by Deta Space, they will give you a subdomain and handle HTTPS automatically.
-- **Running on startup**: Handled by Deta Space, as part of their service.
-- **Restarts**: Handled by Deta Space, as part of their service.
-- **Replication**: Handled by Deta Space, as part of their service.
-- **Authentication**: Handled by Deta Space, as part of their service.
-- **Memory**: Limit predefined by Deta Space, you could contact them to increase it.
-- **Previous steps before starting**: Can be configured using the <a href="https://deta.space/docs/en/reference/spacefile?ref=fastapi" class="external-link" target="_blank">`Spacefile`</a>.
-
-!!! note
-    Deta Space is designed to make it easy and free to build cloud applications for yourself. Then you can optionally share them with anyone.
-
-    It can simplify several use cases, but at the same time, it doesn't support others, like using external databases (apart from Deta's own NoSQL database system), custom virtual machines, etc.
-
-    You can read more details in the <a href="https://deta.space/docs/en/basics/micros?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a> to see if it's the right choice for you.
diff --git a/docs/en/docs/deployment/server-workers.md b/docs/en/docs/deployment/server-workers.md
index 4ccd9d9f6..2df9f3d43 100644
--- a/docs/en/docs/deployment/server-workers.md
+++ b/docs/en/docs/deployment/server-workers.md
@@ -90,7 +90,9 @@ Let's see what each of those options mean:
         ```
 
     * So, the colon in `main:app` would be equivalent to the Python `import` part in `from main import app`.
+
 * `--workers`: The number of worker processes to use, each will run a Uvicorn worker, in this case, 4 workers.
+
 * `--worker-class`: The Gunicorn-compatible worker class to use in the worker processes.
     * Here we pass the class that Gunicorn can import and use with:
 
diff --git a/docs/en/docs/external-links.md b/docs/en/docs/external-links.md
index 0c91470bc..b89021ee2 100644
--- a/docs/en/docs/external-links.md
+++ b/docs/en/docs/external-links.md
@@ -9,79 +9,21 @@ Here's an incomplete list of some of them.
 !!! tip
     If you have an article, project, tool, or anything related to **FastAPI** that is not yet listed here, create a <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request adding it</a>.
 
-## Articles
+{% for section_name, section_content in external_links.items() %}
 
-### English
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
+
+### {{ 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>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Japanese
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Vietnamese
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Russian
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### German
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Taiwanese
-
-{% if external_links %}
-{% for article in external_links.articles.taiwanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Podcasts
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Talks
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
 
 ## Projects
 
diff --git a/docs/en/docs/fastapi-people.md b/docs/en/docs/fastapi-people.md
index 20caaa1ee..7e26358d8 100644
--- a/docs/en/docs/fastapi-people.md
+++ b/docs/en/docs/fastapi-people.md
@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 # FastAPI People
 
 FastAPI has an amazing community that welcomes people from all backgrounds.
diff --git a/docs/en/docs/features.md b/docs/en/docs/features.md
index 98f37b534..6f13b03bb 100644
--- a/docs/en/docs/features.md
+++ b/docs/en/docs/features.md
@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 # Features
 
 ## FastAPI features
diff --git a/docs/en/docs/help-fastapi.md b/docs/en/docs/help-fastapi.md
index e977dba20..8199c9b9a 100644
--- a/docs/en/docs/help-fastapi.md
+++ b/docs/en/docs/help-fastapi.md
@@ -231,8 +231,6 @@ Join the 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" targ
 
     Use the chat only for other general conversations.
 
-There is also the previous <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">Gitter chat</a>, but as it doesn't have channels and advanced features, conversations are more difficult, so Discord is now the recommended system.
-
 ### Don't use the chat for questions
 
 Have in mind that as chats allow more "free conversation", it's easy to ask questions that are too general and more difficult to answer, so, you might not receive answers.
diff --git a/docs/en/docs/help/index.md b/docs/en/docs/help/index.md
new file mode 100644
index 000000000..5ee7df2fe
--- /dev/null
+++ b/docs/en/docs/help/index.md
@@ -0,0 +1,3 @@
+# Help
+
+Help and get help, contribute, get involved. 🤝
diff --git a/docs/en/docs/advanced/async-sql-databases.md b/docs/en/docs/how-to/async-sql-encode-databases.md
similarity index 98%
rename from docs/en/docs/advanced/async-sql-databases.md
rename to docs/en/docs/how-to/async-sql-encode-databases.md
index 12549a190..697167f79 100644
--- a/docs/en/docs/advanced/async-sql-databases.md
+++ b/docs/en/docs/how-to/async-sql-encode-databases.md
@@ -1,4 +1,4 @@
-# Async SQL (Relational) Databases
+# Async SQL (Relational) Databases with Encode/Databases
 
 !!! info
     These docs are about to be updated. 🎉
diff --git a/docs/en/docs/advanced/conditional-openapi.md b/docs/en/docs/how-to/conditional-openapi.md
similarity index 100%
rename from docs/en/docs/advanced/conditional-openapi.md
rename to docs/en/docs/how-to/conditional-openapi.md
diff --git a/docs/en/docs/how-to/configure-swagger-ui.md b/docs/en/docs/how-to/configure-swagger-ui.md
new file mode 100644
index 000000000..f36ba5ba8
--- /dev/null
+++ b/docs/en/docs/how-to/configure-swagger-ui.md
@@ -0,0 +1,78 @@
+# Configure Swagger UI
+
+You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI parameters</a>.
+
+To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.
+
+`swagger_ui_parameters` receives a dictionary with the configurations passed to Swagger UI directly.
+
+FastAPI converts the configurations to **JSON** to make them compatible with JavaScript, as that's what Swagger UI needs.
+
+## Disable Syntax Highlighting
+
+For example, you could disable syntax highlighting in Swagger UI.
+
+Without changing the settings, syntax highlighting is enabled by default:
+
+<img src="/img/tutorial/extending-openapi/image02.png">
+
+But you can disable it by setting `syntaxHighlight` to `False`:
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+```
+
+...and then Swagger UI won't show the syntax highlighting anymore:
+
+<img src="/img/tutorial/extending-openapi/image03.png">
+
+## Change the Theme
+
+The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+```
+
+That configuration would change the syntax highlighting color theme:
+
+<img src="/img/tutorial/extending-openapi/image04.png">
+
+## Change Default Swagger UI Parameters
+
+FastAPI includes some default configuration parameters appropriate for most of the use cases.
+
+It includes these default configurations:
+
+```Python
+{!../../../fastapi/openapi/docs.py[ln:7-13]!}
+```
+
+You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
+
+For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+```
+
+## Other Swagger UI Parameters
+
+To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
+
+## JavaScript-only settings
+
+Swagger UI also allows other configurations to be **JavaScript-only** objects (for example, JavaScript functions).
+
+FastAPI also includes these JavaScript-only `presets` settings:
+
+```JavaScript
+presets: [
+    SwaggerUIBundle.presets.apis,
+    SwaggerUIBundle.SwaggerUIStandalonePreset
+]
+```
+
+These are **JavaScript** objects, not strings, so you can't pass them from Python code directly.
+
+If you need to use JavaScript-only configurations like those, you can use one of the methods above. Override all the Swagger UI *path operation* and manually write any JavaScript you need.
diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
new file mode 100644
index 000000000..9726be2c7
--- /dev/null
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -0,0 +1,199 @@
+# Custom Docs UI Static Assets (Self-Hosting)
+
+The API docs use **Swagger UI** and **ReDoc**, and each of those need some JavaScript and CSS files.
+
+By default, those files are served from a <abbr title="Content Delivery Network: A service, normally composed of several servers, that provides static files, like JavaScript and CSS. It's commonly used to serve those files from the server closer to the client, improving performance.">CDN</abbr>.
+
+But it's possible to customize it, you can set a specific CDN, or serve the files yourself.
+
+## Custom CDN for JavaScript and CSS
+
+Let's say that you want to use a different <abbr title="Content Delivery Network">CDN</abbr>, for example you want to use `https://unpkg.com/`.
+
+This could be useful if for example you live in a country that restricts some URLs.
+
+### Disable the automatic docs
+
+The first step is to disable the automatic docs, as by default, those use the default CDN.
+
+To disable them, set their URLs to `None` when creating your `FastAPI` app:
+
+```Python hl_lines="8"
+{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+### Include the custom docs
+
+Now you can create the *path operations* for the custom docs.
+
+You can re-use FastAPI's internal functions to create the HTML pages for the docs, and pass them the needed arguments:
+
+* `openapi_url`: the URL where the HTML page for the docs can get the OpenAPI schema for your API. You can use here the attribute `app.openapi_url`.
+* `title`: the title of your API.
+* `oauth2_redirect_url`: you can use `app.swagger_ui_oauth2_redirect_url` here to use the default.
+* `swagger_js_url`: the URL where the HTML for your Swagger UI docs can get the **JavaScript** file. This is the custom CDN URL.
+* `swagger_css_url`: the URL where the HTML for your Swagger UI docs can get the **CSS** file. This is the custom CDN URL.
+
+And similarly for ReDoc...
+
+```Python hl_lines="2-6  11-19  22-24  27-33"
+{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+!!! tip
+    The *path operation* for `swagger_ui_redirect` is a helper for when you use OAuth2.
+
+    If you integrate your API with an OAuth2 provider, you will be able to authenticate and come back to the API docs with the acquired credentials. And interact with it using the real OAuth2 authentication.
+
+    Swagger UI will handle it behind the scenes for you, but it needs this "redirect" helper.
+
+### Create a *path operation* to test it
+
+Now, to be able to test that everything works, create a *path operation*:
+
+```Python hl_lines="36-38"
+{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+### Test it
+
+Now, you should be able to go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page, it will load those assets from the new CDN.
+
+## Self-hosting JavaScript and CSS for docs
+
+Self-hosting the JavaScript and CSS could be useful if, for example, you need your app to keep working even while offline, without open Internet access, or in a local network.
+
+Here you'll see how to serve those files yourself, in the same FastAPI app, and configure the docs to use them.
+
+### Project file structure
+
+Let's say your project file structure looks like this:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+```
+
+Now create a directory to store those static files.
+
+Your new file structure could look like this:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+└── static/
+```
+
+### Download the files
+
+Download the static files needed for the docs and put them on that `static/` directory.
+
+You can probably right-click each link and select an option similar to `Save link as...`.
+
+**Swagger UI** uses the files:
+
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
+
+And **ReDoc** uses the file:
+
+* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
+
+After that, your file structure could look like:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+└── static
+    ├── redoc.standalone.js
+    ├── swagger-ui-bundle.js
+    └── swagger-ui.css
+```
+
+### Serve the static files
+
+* Import `StaticFiles`.
+* "Mount" a `StaticFiles()` instance in a specific path.
+
+```Python hl_lines="7  11"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Test the static files
+
+Start your application and go to <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
+
+You should see a very long JavaScript file for **ReDoc**.
+
+It could start with something like:
+
+```JavaScript
+/*!
+ * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
+ * -------------------------------------------------------------
+ *   Version: "2.0.0-rc.18"
+ *   Repo: https://github.com/Redocly/redoc
+ */
+!function(e,t){"object"==typeof exports&&"object"==typeof m
+
+...
+```
+
+That confirms that you are being able to serve static files from your app, and that you placed the static files for the docs in the correct place.
+
+Now we can configure the app to use those static files for the docs.
+
+### Disable the automatic docs for static files
+
+The same as when using a custom CDN, the first step is to disable the automatic docs, as those use the CDN by default.
+
+To disable them, set their URLs to `None` when creating your `FastAPI` app:
+
+```Python hl_lines="9"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Include the custom docs for static files
+
+And the same way as with a custom CDN, now you can create the *path operations* for the custom docs.
+
+Again, you can re-use FastAPI's internal functions to create the HTML pages for the docs, and pass them the needed arguments:
+
+* `openapi_url`: the URL where the HTML page for the docs can get the OpenAPI schema for your API. You can use here the attribute `app.openapi_url`.
+* `title`: the title of your API.
+* `oauth2_redirect_url`: you can use `app.swagger_ui_oauth2_redirect_url` here to use the default.
+* `swagger_js_url`: the URL where the HTML for your Swagger UI docs can get the **JavaScript** file. **This is the one that your own app is now serving**.
+* `swagger_css_url`: the URL where the HTML for your Swagger UI docs can get the **CSS** file. **This is the one that your own app is now serving**.
+
+And similarly for ReDoc...
+
+```Python hl_lines="2-6  14-22  25-27  30-36"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+!!! tip
+    The *path operation* for `swagger_ui_redirect` is a helper for when you use OAuth2.
+
+    If you integrate your API with an OAuth2 provider, you will be able to authenticate and come back to the API docs with the acquired credentials. And interact with it using the real OAuth2 authentication.
+
+    Swagger UI will handle it behind the scenes for you, but it needs this "redirect" helper.
+
+### Create a *path operation* to test static files
+
+Now, to be able to test that everything works, create a *path operation*:
+
+```Python hl_lines="39-41"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Test Static Files UI
+
+Now, you should be able to disconnect your WiFi, go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page.
+
+And even without Internet, you would be able to see the docs for your API and interact with it.
diff --git a/docs/en/docs/advanced/custom-request-and-route.md b/docs/en/docs/how-to/custom-request-and-route.md
similarity index 100%
rename from docs/en/docs/advanced/custom-request-and-route.md
rename to docs/en/docs/how-to/custom-request-and-route.md
diff --git a/docs/en/docs/how-to/extending-openapi.md b/docs/en/docs/how-to/extending-openapi.md
new file mode 100644
index 000000000..a18fd737e
--- /dev/null
+++ b/docs/en/docs/how-to/extending-openapi.md
@@ -0,0 +1,87 @@
+# Extending OpenAPI
+
+There are some cases where you might need to modify the generated OpenAPI schema.
+
+In this section you will see how.
+
+## The normal process
+
+The normal (default) process, is as follows.
+
+A `FastAPI` application (instance) has an `.openapi()` method that is expected to return the OpenAPI schema.
+
+As part of the application object creation, a *path operation* for `/openapi.json` (or for whatever you set your `openapi_url`) is registered.
+
+It just returns a JSON response with the result of the application's `.openapi()` method.
+
+By default, what the method `.openapi()` does is check the property `.openapi_schema` to see if it has contents and return them.
+
+If it doesn't, it generates them using the utility function at `fastapi.openapi.utils.get_openapi`.
+
+And that function `get_openapi()` receives as parameters:
+
+* `title`: The OpenAPI title, shown in the docs.
+* `version`: The version of your API, e.g. `2.5.0`.
+* `openapi_version`: The version of the OpenAPI specification used. By default, the latest: `3.1.0`.
+* `summary`: A short summary of the API.
+* `description`: The description of your API, this can include markdown and will be shown in the docs.
+* `routes`: A list of routes, these are each of the registered *path operations*. They are taken from `app.routes`.
+
+!!! info
+    The parameter `summary` is available in OpenAPI 3.1.0 and above, supported by FastAPI 0.99.0 and above.
+
+## Overriding the defaults
+
+Using the information above, you can use the same utility function to generate the OpenAPI schema and override each part that you need.
+
+For example, let's add <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">ReDoc's OpenAPI extension to include a custom logo</a>.
+
+### Normal **FastAPI**
+
+First, write all your **FastAPI** application as normally:
+
+```Python hl_lines="1  4  7-9"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Generate the OpenAPI schema
+
+Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
+
+```Python hl_lines="2  15-21"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Modify the OpenAPI schema
+
+Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
+
+```Python hl_lines="22-24"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Cache the OpenAPI schema
+
+You can use the property `.openapi_schema` as a "cache", to store your generated schema.
+
+That way, your application won't have to generate the schema every time a user opens your API docs.
+
+It will be generated only once, and then the same cached schema will be used for the next requests.
+
+```Python hl_lines="13-14  25-26"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Override the method
+
+Now you can replace the `.openapi()` method with your new function.
+
+```Python hl_lines="29"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Check it
+
+Once you go to <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> you will see that you are using your custom logo (in this example, **FastAPI**'s logo):
+
+<img src="/img/tutorial/extending-openapi/image01.png">
diff --git a/docs/en/docs/how-to/general.md b/docs/en/docs/how-to/general.md
new file mode 100644
index 000000000..04367c6b7
--- /dev/null
+++ b/docs/en/docs/how-to/general.md
@@ -0,0 +1,39 @@
+# General - How To - Recipes
+
+Here are several pointers to other places in the docs, for general or frequent questions.
+
+## Filter Data - Security
+
+To ensure that you don't return more data than you should, read the docs for [Tutorial - Response Model - Return Type](../tutorial/response-model.md){.internal-link target=_blank}.
+
+## Documentation Tags - OpenAPI
+
+To add tags to your *path operations*, and group them in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Tags](../tutorial/path-operation-configuration.md#tags){.internal-link target=_blank}.
+
+## Documentation Summary and Description - OpenAPI
+
+To add a summary and description to your *path operations*, and show them in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Summary and Description](../tutorial/path-operation-configuration.md#summary-and-description){.internal-link target=_blank}.
+
+## Documentation Response description - OpenAPI
+
+To define the description of the response, shown in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Response description](../tutorial/path-operation-configuration.md#response-description){.internal-link target=_blank}.
+
+## Documentation Deprecate a *Path Operation* - OpenAPI
+
+To deprecate a *path operation*, and show it in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Deprecation](../tutorial/path-operation-configuration.md#deprecate-a-path-operation){.internal-link target=_blank}.
+
+## Convert any Data to JSON-compatible
+
+To convert any data to JSON-compatible, read the docs for [Tutorial - JSON Compatible Encoder](../tutorial/encoder.md){.internal-link target=_blank}.
+
+## OpenAPI Metadata - Docs
+
+To add metadata to your OpenAPI schema, including a license, version, contact, etc, read the docs for [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md){.internal-link target=_blank}.
+
+## OpenAPI Custom URL
+
+To customize the OpenAPI URL (or remove it), read the docs for [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#openapi-url){.internal-link target=_blank}.
+
+## OpenAPI Docs URLs
+
+To update the URLs used for the automatically generated docs user interfaces, read the docs for [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#docs-urls){.internal-link target=_blank}.
diff --git a/docs/en/docs/advanced/graphql.md b/docs/en/docs/how-to/graphql.md
similarity index 100%
rename from docs/en/docs/advanced/graphql.md
rename to docs/en/docs/how-to/graphql.md
diff --git a/docs/en/docs/how-to/index.md b/docs/en/docs/how-to/index.md
new file mode 100644
index 000000000..ec7fd38f8
--- /dev/null
+++ b/docs/en/docs/how-to/index.md
@@ -0,0 +1,11 @@
+# How To - Recipes
+
+Here you will see different recipes or "how to" guides for **several topics**.
+
+Most of these ideas would be more or less **independent**, and in most cases you should only need to study them if they apply directly to **your project**.
+
+If something seems interesting and useful to your project, go ahead and check it, but otherwise, you might probably just skip them.
+
+!!! tip
+
+    If you want to **learn FastAPI** in a structured way (recommended), go and read the [Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} chapter by chapter instead.
diff --git a/docs/en/docs/advanced/nosql-databases.md b/docs/en/docs/how-to/nosql-databases-couchbase.md
similarity index 99%
rename from docs/en/docs/advanced/nosql-databases.md
rename to docs/en/docs/how-to/nosql-databases-couchbase.md
index 606db35c7..ae6ad604b 100644
--- a/docs/en/docs/advanced/nosql-databases.md
+++ b/docs/en/docs/how-to/nosql-databases-couchbase.md
@@ -1,4 +1,4 @@
-# NoSQL (Distributed / Big Data) Databases
+# NoSQL (Distributed / Big Data) Databases with Couchbase
 
 !!! info
     These docs are about to be updated. 🎉
diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
new file mode 100644
index 000000000..10be1071a
--- /dev/null
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -0,0 +1,231 @@
+# Separate OpenAPI Schemas for Input and Output or Not
+
+When using **Pydantic v2**, the generated OpenAPI is a bit more exact and **correct** than before. 😎
+
+In fact, in some cases, it will even have **two JSON Schemas** in OpenAPI for the same Pydantic model, for input and output, depending on if they have **default values**.
+
+Let's see how that works and how to change it if you need to do that.
+
+## Pydantic Models for Input and Output
+
+Let's say you have a Pydantic model with default values, like this one:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+    ```
+
+    </details>
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+    ```
+
+    </details>
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+    ```
+
+    </details>
+
+### Model for Input
+
+If you use this model as an input like here:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+    ```
+
+    </details>
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+    ```
+
+    </details>
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+    ```
+
+    </details>
+
+...then the `description` field will **not be required**. Because it has a default value of `None`.
+
+### Input Model in Docs
+
+You can confirm that in the docs, the `description` field doesn't have a **red asterisk**, it's not marked as required:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image01.png">
+</div>
+
+### Model for Output
+
+But if you use the same model as an output, like here:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+    ```
+
+...then because `description` has a default value, if you **don't return anything** for that field, it will still have that **default value**.
+
+### Model for Output Response Data
+
+If you interact with the docs and check the response, even though the code didn't add anything in one of the `description` fields, the JSON response contains the default value (`null`):
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image02.png">
+</div>
+
+This means that it will **always have a value**, it's just that sometimes the value could be `None` (or `null` in JSON).
+
+That means that, clients using your API don't have to check if the value exists or not, they can **assume the field will always be there**, but just that in some cases it will have the default value of `None`.
+
+The way to describe this in OpenAPI, is to mark that field as **required**, because it will always be there.
+
+Because of that, the JSON Schema for a model can be different depending on if it's used for **input or output**:
+
+* for **input** the `description` will **not be required**
+* for **output** it will be **required** (and possibly `None`, or in JSON terms, `null`)
+
+### Model for Output in Docs
+
+You can check the output model in the docs too, **both** `name` and `description` are marked as **required** with a **red asterisk**:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image03.png">
+</div>
+
+### Model for Input and Output in Docs
+
+And if you check all the available Schemas (JSON Schemas) in OpenAPI, you will see that there are two, one `Item-Input` and one `Item-Output`.
+
+For `Item-Input`, `description` is **not required**, it doesn't have a red asterisk.
+
+But for `Item-Output`, `description` is **required**, it has a red asterisk.
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image04.png">
+</div>
+
+With this feature from **Pydantic v2**, your API documentation is more **precise**, and if you have autogenerated clients and SDKs, they will be more precise too, with a better **developer experience** and consistency. 🎉
+
+## Do not Separate Schemas
+
+Now, there are some cases where you might want to have the **same schema for input and output**.
+
+Probably the main use case for this is if you already have some autogenerated client code/SDKs and you don't want to update all the autogenerated client code/SDKs yet, you probably will want to do it at some point, but maybe not right now.
+
+In that case, you can disable this feature in **FastAPI**, with the parameter `separate_input_output_schemas=False`.
+
+!!! info
+    Support for `separate_input_output_schemas` was added in FastAPI `0.102.0`. 🤓
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial002.py!}
+    ```
+
+### Same Schema for Input and Output Models in Docs
+
+And now there will be one single schema for input and output for the model, only `Item`, and it will have `description` as **not required**:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image05.png">
+</div>
+
+This is the same behavior as in Pydantic v1. 🤓
diff --git a/docs/en/docs/advanced/sql-databases-peewee.md b/docs/en/docs/how-to/sql-databases-peewee.md
similarity index 99%
rename from docs/en/docs/advanced/sql-databases-peewee.md
rename to docs/en/docs/how-to/sql-databases-peewee.md
index 6a469634f..b0ab7c633 100644
--- a/docs/en/docs/advanced/sql-databases-peewee.md
+++ b/docs/en/docs/how-to/sql-databases-peewee.md
@@ -12,6 +12,8 @@
 
     Because Pewee doesn't play well with anything async and there are better alternatives, I won't update these docs for Pydantic v2, they are kept for now only for historical purposes.
 
+    The examples here are no longer tested in CI (as they were before).
+
 If you are starting a project from scratch, you are probably better off with SQLAlchemy ORM ([SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank}), or any other async ORM.
 
 If you already have a code base that uses <a href="https://docs.peewee-orm.com/en/latest/" class="external-link" target="_blank">Peewee ORM</a>, you can check here how to use it with **FastAPI**.
@@ -361,7 +363,7 @@ It will have the database connection open at the beginning and will just wait so
 
 This will easily let you test that your app with Peewee and FastAPI is behaving correctly with all the stuff about threads.
 
-If you want to check how Peewee would break your app if used without modification, go the the `sql_app/database.py` file and comment the line:
+If you want to check how Peewee would break your app if used without modification, go the `sql_app/database.py` file and comment the line:
 
 ```Python
 # db._state = PeeweeConnectionState()
diff --git a/docs/en/docs/img/sponsors/bump-sh-banner.png b/docs/en/docs/img/sponsors/bump-sh-banner.png
new file mode 100755
index 000000000..e75c0facd
Binary files /dev/null and b/docs/en/docs/img/sponsors/bump-sh-banner.png differ
diff --git a/docs/en/docs/img/sponsors/bump-sh-banner.svg b/docs/en/docs/img/sponsors/bump-sh-banner.svg
new file mode 100644
index 000000000..c8ec7675a
--- /dev/null
+++ b/docs/en/docs/img/sponsors/bump-sh-banner.svg
@@ -0,0 +1,48 @@
+<svg width="300" height="40" viewBox="0 0 300 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_12187_586)">
+<rect width="300" height="40" fill="#2E303E"/>
+<g opacity="0.3" filter="url(#filter0_f_12187_586)">
+<rect width="300" height="40" fill="url(#paint0_radial_12187_586)"/>
+<rect width="300" height="40" fill="url(#paint1_radial_12187_586)"/>
+<rect width="300" height="40" fill="url(#paint2_radial_12187_586)"/>
+</g>
+<rect x="0.1" y="0.1" width="299.8" height="39.8" rx="19.9" stroke="url(#paint3_linear_12187_586)" stroke-opacity="0.2" stroke-width="0.2"/>
+<path d="M27.9124 13.9215C29.3259 13.9215 30.4718 15.0584 30.4718 16.4608C30.4718 17.8631 29.3259 19 27.9124 19L24.5 19L24.5 13.9215L27.9124 13.9215Z" fill="white"/>
+<path d="M36.5905 16.4608C36.5905 17.8631 35.4446 19 34.0312 19C32.6177 19 31.4718 17.8631 31.4718 16.4608C31.4718 15.0584 32.6177 13.9215 34.0312 13.9215C35.4446 13.9215 36.5905 15.0584 36.5905 16.4608Z" fill="url(#paint4_linear_12187_586)"/>
+<path d="M34.7374 20C36.1508 20 37.2967 21.1369 37.2967 22.5393C37.2967 23.9417 36.1508 25.0785 34.7374 25.0785L24.5 25.0785L24.5 20L34.7374 20Z" fill="white"/>
+<path d="M51.7018 18.355C51.7018 18.789 51.6213 19.1565 51.4603 19.4575C51.2993 19.7515 51.0823 19.9895 50.8093 20.1715C50.5363 20.3535 50.2213 20.4865 49.8643 20.5705C49.5073 20.6545 49.1363 20.6965 48.7513 20.6965H47.8588V23.5H46.0633V16.066H48.7933C49.1993 16.066 49.5773 16.108 49.9273 16.192C50.2843 16.269 50.5923 16.3985 50.8513 16.5805C51.1173 16.7555 51.3238 16.99 51.4708 17.284C51.6248 17.571 51.7018 17.928 51.7018 18.355ZM49.9063 18.3655C49.9063 18.1905 49.8713 18.047 49.8013 17.935C49.7313 17.823 49.6368 17.7355 49.5178 17.6725C49.3988 17.6095 49.2623 17.5675 49.1083 17.5465C48.9613 17.5255 48.8073 17.515 48.6463 17.515H47.8588V19.2685H48.6148C48.7828 19.2685 48.9438 19.2545 49.0978 19.2265C49.2518 19.1985 49.3883 19.1495 49.5073 19.0795C49.6333 19.0095 49.7313 18.9185 49.8013 18.8065C49.8713 18.6875 49.9063 18.5405 49.9063 18.3655ZM55.6779 23.5V22.7755H55.6569C55.5939 22.8945 55.5099 23.0065 55.4049 23.1115C55.3069 23.2165 55.1879 23.3075 55.0479 23.3845C54.9149 23.4615 54.7644 23.5245 54.5964 23.5735C54.4354 23.6225 54.2639 23.647 54.0819 23.647C53.7319 23.647 53.4344 23.584 53.1894 23.458C52.9514 23.332 52.7554 23.171 52.6014 22.975C52.4544 22.772 52.3459 22.5445 52.2759 22.2925C52.2129 22.0335 52.1814 21.771 52.1814 21.505V18.271H53.9139V21.106C53.9139 21.253 53.9244 21.393 53.9454 21.526C53.9664 21.659 54.0049 21.778 54.0609 21.883C54.1239 21.988 54.2044 22.072 54.3024 22.135C54.4004 22.191 54.5299 22.219 54.6909 22.219C54.9919 22.219 55.2194 22.107 55.3734 21.883C55.5344 21.659 55.6149 21.3965 55.6149 21.0955V18.271H57.3369V23.5H55.6779ZM64.5111 20.8645C64.5111 21.2285 64.4551 21.5785 64.3431 21.9145C64.2311 22.2505 64.0666 22.548 63.8496 22.807C63.6396 23.059 63.3806 23.262 63.0726 23.416C62.7646 23.57 62.4146 23.647 62.0226 23.647C61.6726 23.647 61.3401 23.577 61.0251 23.437C60.7171 23.29 60.4791 23.0835 60.3111 22.8175H60.2901V23.5H58.7046V15.562H60.4266V18.8275H60.4476C60.5946 18.6525 60.8011 18.4915 61.0671 18.3445C61.3331 18.1975 61.6586 18.124 62.0436 18.124C62.4216 18.124 62.7611 18.1975 63.0621 18.3445C63.3701 18.4915 63.6291 18.691 63.8391 18.943C64.0561 19.195 64.2206 19.489 64.3326 19.825C64.4516 20.154 64.5111 20.5005 64.5111 20.8645ZM62.8521 20.8645C62.8521 20.6965 62.8241 20.532 62.7681 20.371C62.7191 20.21 62.6421 20.07 62.5371 19.951C62.4321 19.825 62.3026 19.7235 62.1486 19.6465C61.9946 19.5695 61.8161 19.531 61.6131 19.531C61.4171 19.531 61.2421 19.5695 61.0881 19.6465C60.9341 19.7235 60.8011 19.825 60.6891 19.951C60.5841 20.077 60.5001 20.2205 60.4371 20.3815C60.3811 20.5425 60.3531 20.707 60.3531 20.875C60.3531 21.043 60.3811 21.2075 60.4371 21.3685C60.5001 21.5295 60.5841 21.673 60.6891 21.799C60.8011 21.925 60.9341 22.0265 61.0881 22.1035C61.2421 22.1805 61.4171 22.219 61.6131 22.219C61.8161 22.219 61.9946 22.1805 62.1486 22.1035C62.3026 22.0265 62.4321 21.925 62.5371 21.799C62.6421 21.673 62.7191 21.5295 62.7681 21.3685C62.8241 21.2005 62.8521 21.0325 62.8521 20.8645ZM65.626 23.5V15.562H67.369V23.5H65.626ZM70.6014 16.6015C70.6014 16.7345 70.5734 16.8605 70.5174 16.9795C70.4684 17.0915 70.3984 17.1895 70.3074 17.2735C70.2234 17.3575 70.1184 17.424 69.9924 17.473C69.8734 17.522 69.7474 17.5465 69.6144 17.5465C69.3344 17.5465 69.0999 17.4555 68.9109 17.2735C68.7219 17.0845 68.6274 16.8605 68.6274 16.6015C68.6274 16.4755 68.6519 16.3565 68.7009 16.2445C68.7499 16.1255 68.8199 16.024 68.9109 15.94C69.0019 15.856 69.1069 15.7895 69.2259 15.7405C69.3449 15.6845 69.4744 15.6565 69.6144 15.6565C69.7474 15.6565 69.8734 15.681 69.9924 15.73C70.1184 15.779 70.2234 15.8455 70.3074 15.9295C70.3984 16.0135 70.4684 16.115 70.5174 16.234C70.5734 16.346 70.6014 16.4685 70.6014 16.6015ZM68.7534 23.5V18.271H70.4754V23.5H68.7534ZM74.9159 19.8145C74.7759 19.6815 74.6114 19.5695 74.4224 19.4785C74.2334 19.3875 74.0339 19.342 73.8239 19.342C73.6629 19.342 73.5124 19.3735 73.3724 19.4365C73.2394 19.4995 73.1729 19.608 73.1729 19.762C73.1729 19.909 73.2464 20.014 73.3934 20.077C73.5474 20.14 73.7924 20.21 74.1284 20.287C74.3244 20.329 74.5204 20.3885 74.7164 20.4655C74.9194 20.5425 75.1014 20.644 75.2624 20.77C75.4234 20.896 75.5529 21.05 75.6509 21.232C75.7489 21.414 75.7979 21.631 75.7979 21.883C75.7979 22.212 75.7314 22.492 75.5984 22.723C75.4654 22.947 75.2904 23.129 75.0734 23.269C74.8634 23.409 74.6254 23.5105 74.3594 23.5735C74.0934 23.6365 73.8274 23.668 73.5614 23.668C73.1344 23.668 72.7144 23.6015 72.3014 23.4685C71.8954 23.3285 71.5559 23.1255 71.2829 22.8595L72.2489 21.841C72.4029 22.009 72.5919 22.149 72.8159 22.261C73.0399 22.373 73.2779 22.429 73.5299 22.429C73.6699 22.429 73.8064 22.3975 73.9394 22.3345C74.0794 22.2645 74.1494 22.1455 74.1494 21.9775C74.1494 21.8165 74.0654 21.6975 73.8974 21.6205C73.7294 21.5435 73.4669 21.463 73.1099 21.379C72.9279 21.337 72.7459 21.281 72.5639 21.211C72.3819 21.141 72.2174 21.0465 72.0704 20.9275C71.9304 20.8085 71.8149 20.6615 71.7239 20.4865C71.6329 20.3115 71.5874 20.1015 71.5874 19.8565C71.5874 19.5415 71.6539 19.2755 71.7869 19.0585C71.9199 18.8345 72.0914 18.6525 72.3014 18.5125C72.5114 18.3725 72.7424 18.271 72.9944 18.208C73.2534 18.138 73.5089 18.103 73.7609 18.103C74.1529 18.103 74.5344 18.166 74.9054 18.292C75.2834 18.411 75.6019 18.593 75.8609 18.838L74.9159 19.8145ZM80.236 23.5V20.665C80.236 20.518 80.2255 20.378 80.2045 20.245C80.1835 20.112 80.1415 19.9965 80.0785 19.8985C80.0225 19.7935 79.9455 19.713 79.8475 19.657C79.7495 19.594 79.6235 19.5625 79.4695 19.5625C79.1685 19.5625 78.9375 19.671 78.7765 19.888C78.6155 20.098 78.535 20.3605 78.535 20.6755V23.5H76.813V15.562H78.535V18.9325H78.556C78.675 18.7225 78.864 18.537 79.123 18.376C79.382 18.208 79.6935 18.124 80.0575 18.124C80.4145 18.124 80.712 18.187 80.95 18.313C81.195 18.439 81.391 18.6035 81.538 18.8065C81.692 19.0025 81.8005 19.23 81.8635 19.489C81.9335 19.748 81.9685 20.007 81.9685 20.266V23.5H80.236ZM90.8474 23.5L90.2699 22.0405H87.3929L86.8469 23.5H84.8939L88.0124 16.066H89.7554L92.8424 23.5H90.8474ZM88.8524 18.0505L87.9074 20.602H89.7764L88.8524 18.0505ZM99.0953 18.355C99.0953 18.789 99.0148 19.1565 98.8538 19.4575C98.6928 19.7515 98.4758 19.9895 98.2028 20.1715C97.9298 20.3535 97.6148 20.4865 97.2578 20.5705C96.9008 20.6545 96.5298 20.6965 96.1448 20.6965H95.2523V23.5H93.4568V16.066H96.1868C96.5928 16.066 96.9708 16.108 97.3208 16.192C97.6778 16.269 97.9858 16.3985 98.2448 16.5805C98.5108 16.7555 98.7173 16.99 98.8643 17.284C99.0183 17.571 99.0953 17.928 99.0953 18.355ZM97.2998 18.3655C97.2998 18.1905 97.2648 18.047 97.1948 17.935C97.1248 17.823 97.0303 17.7355 96.9113 17.6725C96.7923 17.6095 96.6558 17.5675 96.5018 17.5465C96.3548 17.5255 96.2008 17.515 96.0398 17.515H95.2523V19.2685H96.0083C96.1763 19.2685 96.3373 19.2545 96.4913 19.2265C96.6453 19.1985 96.7818 19.1495 96.9008 19.0795C97.0268 19.0095 97.1248 18.9185 97.1948 18.8065C97.2648 18.6875 97.2998 18.5405 97.2998 18.3655ZM100.173 23.5V16.066H101.979V23.5H100.173ZM110.005 23.5V22.8175H109.984C109.816 23.0835 109.574 23.29 109.259 23.437C108.951 23.577 108.622 23.647 108.272 23.647C107.88 23.647 107.53 23.57 107.222 23.416C106.914 23.262 106.652 23.059 106.435 22.807C106.225 22.548 106.064 22.2505 105.952 21.9145C105.84 21.5785 105.784 21.2285 105.784 20.8645C105.784 20.5005 105.84 20.154 105.952 19.825C106.071 19.489 106.235 19.195 106.445 18.943C106.662 18.691 106.921 18.4915 107.222 18.3445C107.53 18.1975 107.873 18.124 108.251 18.124C108.636 18.124 108.962 18.1975 109.228 18.3445C109.494 18.4915 109.7 18.6525 109.847 18.8275H109.868V15.562H111.59V23.5H110.005ZM109.942 20.875C109.942 20.707 109.91 20.5425 109.847 20.3815C109.791 20.2205 109.707 20.077 109.595 19.951C109.49 19.825 109.361 19.7235 109.207 19.6465C109.053 19.5695 108.878 19.531 108.682 19.531C108.479 19.531 108.3 19.5695 108.146 19.6465C107.992 19.7235 107.863 19.825 107.758 19.951C107.653 20.07 107.572 20.21 107.516 20.371C107.467 20.532 107.443 20.6965 107.443 20.8645C107.443 21.0325 107.467 21.2005 107.516 21.3685C107.572 21.5295 107.653 21.673 107.758 21.799C107.863 21.925 107.992 22.0265 108.146 22.1035C108.3 22.1805 108.479 22.219 108.682 22.219C108.878 22.219 109.053 22.1805 109.207 22.1035C109.361 22.0265 109.49 21.925 109.595 21.799C109.707 21.673 109.791 21.5295 109.847 21.3685C109.91 21.2075 109.942 21.043 109.942 20.875ZM118.502 20.8645C118.502 21.2915 118.425 21.68 118.271 22.03C118.117 22.373 117.907 22.667 117.641 22.912C117.375 23.15 117.067 23.3355 116.717 23.4685C116.367 23.6015 115.992 23.668 115.593 23.668C115.201 23.668 114.827 23.6015 114.47 23.4685C114.12 23.3355 113.812 23.15 113.546 22.912C113.287 22.667 113.08 22.373 112.926 22.03C112.772 21.68 112.695 21.2915 112.695 20.8645C112.695 20.4375 112.772 20.0525 112.926 19.7095C113.08 19.3665 113.287 19.076 113.546 18.838C113.812 18.6 114.12 18.418 114.47 18.292C114.827 18.166 115.201 18.103 115.593 18.103C115.992 18.103 116.367 18.166 116.717 18.292C117.067 18.418 117.375 18.6 117.641 18.838C117.907 19.076 118.117 19.3665 118.271 19.7095C118.425 20.0525 118.502 20.4375 118.502 20.8645ZM116.843 20.8645C116.843 20.6965 116.815 20.532 116.759 20.371C116.703 20.21 116.622 20.07 116.517 19.951C116.412 19.825 116.283 19.7235 116.129 19.6465C115.975 19.5695 115.796 19.531 115.593 19.531C115.39 19.531 115.212 19.5695 115.058 19.6465C114.904 19.7235 114.774 19.825 114.669 19.951C114.571 20.07 114.494 20.21 114.438 20.371C114.389 20.532 114.365 20.6965 114.365 20.8645C114.365 21.0325 114.389 21.197 114.438 21.358C114.494 21.519 114.575 21.666 114.68 21.799C114.785 21.925 114.914 22.0265 115.068 22.1035C115.222 22.1805 115.401 22.219 115.604 22.219C115.807 22.219 115.985 22.1805 116.139 22.1035C116.293 22.0265 116.423 21.925 116.528 21.799C116.633 21.666 116.71 21.519 116.759 21.358C116.815 21.197 116.843 21.0325 116.843 20.8645ZM123.193 19.9615C123.095 19.8355 122.962 19.734 122.794 19.657C122.626 19.58 122.455 19.5415 122.28 19.5415C122.098 19.5415 121.933 19.58 121.786 19.657C121.639 19.727 121.513 19.825 121.408 19.951C121.303 20.07 121.219 20.21 121.156 20.371C121.1 20.532 121.072 20.7035 121.072 20.8855C121.072 21.0675 121.1 21.239 121.156 21.4C121.212 21.561 121.293 21.7045 121.398 21.8305C121.51 21.9495 121.639 22.044 121.786 22.114C121.94 22.184 122.112 22.219 122.301 22.219C122.476 22.219 122.647 22.1875 122.815 22.1245C122.99 22.0545 123.13 21.9565 123.235 21.8305L124.191 22.996C123.974 23.206 123.694 23.3705 123.351 23.4895C123.008 23.6085 122.644 23.668 122.259 23.668C121.846 23.668 121.461 23.605 121.104 23.479C120.747 23.353 120.435 23.171 120.169 22.933C119.91 22.688 119.704 22.394 119.55 22.051C119.403 21.708 119.329 21.3195 119.329 20.8855C119.329 20.4585 119.403 20.0735 119.55 19.7305C119.704 19.3875 119.91 19.097 120.169 18.859C120.435 18.614 120.747 18.4285 121.104 18.3025C121.461 18.1695 121.842 18.103 122.248 18.103C122.437 18.103 122.623 18.1205 122.805 18.1555C122.994 18.1905 123.172 18.2395 123.34 18.3025C123.515 18.3585 123.673 18.432 123.813 18.523C123.96 18.607 124.086 18.7015 124.191 18.8065L123.193 19.9615ZM127.949 19.8145C127.809 19.6815 127.645 19.5695 127.456 19.4785C127.267 19.3875 127.067 19.342 126.857 19.342C126.696 19.342 126.546 19.3735 126.406 19.4365C126.273 19.4995 126.206 19.608 126.206 19.762C126.206 19.909 126.28 20.014 126.427 20.077C126.581 20.14 126.826 20.21 127.162 20.287C127.358 20.329 127.554 20.3885 127.75 20.4655C127.953 20.5425 128.135 20.644 128.296 20.77C128.457 20.896 128.586 21.05 128.684 21.232C128.782 21.414 128.831 21.631 128.831 21.883C128.831 22.212 128.765 22.492 128.632 22.723C128.499 22.947 128.324 23.129 128.107 23.269C127.897 23.409 127.659 23.5105 127.393 23.5735C127.127 23.6365 126.861 23.668 126.595 23.668C126.168 23.668 125.748 23.6015 125.335 23.4685C124.929 23.3285 124.589 23.1255 124.316 22.8595L125.282 21.841C125.436 22.009 125.625 22.149 125.849 22.261C126.073 22.373 126.311 22.429 126.563 22.429C126.703 22.429 126.84 22.3975 126.973 22.3345C127.113 22.2645 127.183 22.1455 127.183 21.9775C127.183 21.8165 127.099 21.6975 126.931 21.6205C126.763 21.5435 126.5 21.463 126.143 21.379C125.961 21.337 125.779 21.281 125.597 21.211C125.415 21.141 125.251 21.0465 125.104 20.9275C124.964 20.8085 124.848 20.6615 124.757 20.4865C124.666 20.3115 124.621 20.1015 124.621 19.8565C124.621 19.5415 124.687 19.2755 124.82 19.0585C124.953 18.8345 125.125 18.6525 125.335 18.5125C125.545 18.3725 125.776 18.271 126.028 18.208C126.287 18.138 126.542 18.103 126.794 18.103C127.186 18.103 127.568 18.166 127.939 18.292C128.317 18.411 128.635 18.593 128.894 18.838L127.949 19.8145ZM135.537 21.2215H135.317C135.128 21.2215 134.935 21.232 134.739 21.253C134.55 21.267 134.379 21.2985 134.225 21.3475C134.078 21.3965 133.955 21.47 133.857 21.568C133.759 21.659 133.71 21.7815 133.71 21.9355C133.71 22.0335 133.731 22.1175 133.773 22.1875C133.822 22.2575 133.882 22.3135 133.952 22.3555C134.022 22.3975 134.102 22.429 134.193 22.45C134.284 22.464 134.372 22.471 134.456 22.471C134.806 22.471 135.072 22.3765 135.254 22.1875C135.443 21.9915 135.537 21.729 135.537 21.4V21.2215ZM132.377 18.985C132.685 18.691 133.042 18.4705 133.448 18.3235C133.861 18.1765 134.281 18.103 134.708 18.103C135.149 18.103 135.52 18.159 135.821 18.271C136.129 18.376 136.377 18.544 136.566 18.775C136.755 18.999 136.892 19.286 136.976 19.636C137.067 19.979 137.112 20.3885 137.112 20.8645V23.5H135.537V22.9435H135.506C135.373 23.1605 135.17 23.3285 134.897 23.4475C134.631 23.5665 134.34 23.626 134.025 23.626C133.815 23.626 133.598 23.598 133.374 23.542C133.15 23.486 132.944 23.395 132.755 23.269C132.573 23.143 132.422 22.975 132.303 22.765C132.184 22.555 132.125 22.296 132.125 21.988C132.125 21.61 132.226 21.3055 132.429 21.0745C132.639 20.8435 132.905 20.665 133.227 20.539C133.556 20.413 133.92 20.329 134.319 20.287C134.718 20.245 135.107 20.224 135.485 20.224V20.14C135.485 19.881 135.394 19.692 135.212 19.573C135.03 19.447 134.806 19.384 134.54 19.384C134.295 19.384 134.057 19.4365 133.826 19.5415C133.602 19.6465 133.409 19.7725 133.248 19.9195L132.377 18.985ZM141.831 23.5V20.644C141.831 20.497 141.817 20.357 141.789 20.224C141.768 20.091 141.729 19.9755 141.673 19.8775C141.617 19.7725 141.537 19.692 141.432 19.636C141.334 19.573 141.208 19.5415 141.054 19.5415C140.9 19.5415 140.763 19.573 140.644 19.636C140.532 19.692 140.438 19.7725 140.361 19.8775C140.284 19.9825 140.224 20.105 140.182 20.245C140.147 20.378 140.13 20.518 140.13 20.665V23.5H138.397V18.271H140.067V18.9955H140.088C140.151 18.8835 140.231 18.775 140.329 18.67C140.434 18.558 140.553 18.4635 140.686 18.3865C140.826 18.3095 140.977 18.2465 141.138 18.1975C141.299 18.1485 141.47 18.124 141.652 18.124C142.002 18.124 142.3 18.187 142.545 18.313C142.79 18.439 142.986 18.6035 143.133 18.8065C143.287 19.0025 143.395 19.23 143.458 19.489C143.528 19.748 143.563 20.007 143.563 20.266V23.5H141.831ZM148.826 23.5V22.8175H148.805C148.637 23.0835 148.396 23.29 148.081 23.437C147.773 23.577 147.444 23.647 147.094 23.647C146.702 23.647 146.352 23.57 146.044 23.416C145.736 23.262 145.473 23.059 145.256 22.807C145.046 22.548 144.885 22.2505 144.773 21.9145C144.661 21.5785 144.605 21.2285 144.605 20.8645C144.605 20.5005 144.661 20.154 144.773 19.825C144.892 19.489 145.057 19.195 145.267 18.943C145.484 18.691 145.743 18.4915 146.044 18.3445C146.352 18.1975 146.695 18.124 147.073 18.124C147.458 18.124 147.783 18.1975 148.049 18.3445C148.315 18.4915 148.522 18.6525 148.669 18.8275H148.69V15.562H150.412V23.5H148.826ZM148.763 20.875C148.763 20.707 148.732 20.5425 148.669 20.3815C148.613 20.2205 148.529 20.077 148.417 19.951C148.312 19.825 148.182 19.7235 148.028 19.6465C147.874 19.5695 147.699 19.531 147.503 19.531C147.3 19.531 147.122 19.5695 146.968 19.6465C146.814 19.7235 146.684 19.825 146.579 19.951C146.474 20.07 146.394 20.21 146.338 20.371C146.289 20.532 146.264 20.6965 146.264 20.8645C146.264 21.0325 146.289 21.2005 146.338 21.3685C146.394 21.5295 146.474 21.673 146.579 21.799C146.684 21.925 146.814 22.0265 146.968 22.1035C147.122 22.1805 147.3 22.219 147.503 22.219C147.699 22.219 147.874 22.1805 148.028 22.1035C148.182 22.0265 148.312 21.925 148.417 21.799C148.529 21.673 148.613 21.5295 148.669 21.3685C148.732 21.2075 148.763 21.043 148.763 20.875ZM158.005 19.9615C157.907 19.8355 157.774 19.734 157.606 19.657C157.438 19.58 157.267 19.5415 157.092 19.5415C156.91 19.5415 156.745 19.58 156.598 19.657C156.451 19.727 156.325 19.825 156.22 19.951C156.115 20.07 156.031 20.21 155.968 20.371C155.912 20.532 155.884 20.7035 155.884 20.8855C155.884 21.0675 155.912 21.239 155.968 21.4C156.024 21.561 156.105 21.7045 156.21 21.8305C156.322 21.9495 156.451 22.044 156.598 22.114C156.752 22.184 156.924 22.219 157.113 22.219C157.288 22.219 157.459 22.1875 157.627 22.1245C157.802 22.0545 157.942 21.9565 158.047 21.8305L159.003 22.996C158.786 23.206 158.506 23.3705 158.163 23.4895C157.82 23.6085 157.456 23.668 157.071 23.668C156.658 23.668 156.273 23.605 155.916 23.479C155.559 23.353 155.247 23.171 154.981 22.933C154.722 22.688 154.516 22.394 154.362 22.051C154.215 21.708 154.141 21.3195 154.141 20.8855C154.141 20.4585 154.215 20.0735 154.362 19.7305C154.516 19.3875 154.722 19.097 154.981 18.859C155.247 18.614 155.559 18.4285 155.916 18.3025C156.273 18.1695 156.654 18.103 157.06 18.103C157.249 18.103 157.435 18.1205 157.617 18.1555C157.806 18.1905 157.984 18.2395 158.152 18.3025C158.327 18.3585 158.485 18.432 158.625 18.523C158.772 18.607 158.898 18.7015 159.003 18.8065L158.005 19.9615ZM163.129 23.5V20.665C163.129 20.518 163.118 20.378 163.097 20.245C163.076 20.112 163.034 19.9965 162.971 19.8985C162.915 19.7935 162.838 19.713 162.74 19.657C162.642 19.594 162.516 19.5625 162.362 19.5625C162.061 19.5625 161.83 19.671 161.669 19.888C161.508 20.098 161.428 20.3605 161.428 20.6755V23.5H159.706V15.562H161.428V18.9325H161.449C161.568 18.7225 161.757 18.537 162.016 18.376C162.275 18.208 162.586 18.124 162.95 18.124C163.307 18.124 163.605 18.187 163.843 18.313C164.088 18.439 164.284 18.6035 164.431 18.8065C164.585 19.0025 164.693 19.23 164.756 19.489C164.826 19.748 164.861 20.007 164.861 20.266V23.5H163.129ZM169.252 21.2215H169.032C168.843 21.2215 168.65 21.232 168.454 21.253C168.265 21.267 168.094 21.2985 167.94 21.3475C167.793 21.3965 167.67 21.47 167.572 21.568C167.474 21.659 167.425 21.7815 167.425 21.9355C167.425 22.0335 167.446 22.1175 167.488 22.1875C167.537 22.2575 167.597 22.3135 167.667 22.3555C167.737 22.3975 167.817 22.429 167.908 22.45C167.999 22.464 168.087 22.471 168.171 22.471C168.521 22.471 168.787 22.3765 168.969 22.1875C169.158 21.9915 169.252 21.729 169.252 21.4V21.2215ZM166.092 18.985C166.4 18.691 166.757 18.4705 167.163 18.3235C167.576 18.1765 167.996 18.103 168.423 18.103C168.864 18.103 169.235 18.159 169.536 18.271C169.844 18.376 170.092 18.544 170.281 18.775C170.47 18.999 170.607 19.286 170.691 19.636C170.782 19.979 170.827 20.3885 170.827 20.8645V23.5H169.252V22.9435H169.221C169.088 23.1605 168.885 23.3285 168.612 23.4475C168.346 23.5665 168.055 23.626 167.74 23.626C167.53 23.626 167.313 23.598 167.089 23.542C166.865 23.486 166.659 23.395 166.47 23.269C166.288 23.143 166.137 22.975 166.018 22.765C165.899 22.555 165.84 22.296 165.84 21.988C165.84 21.61 165.941 21.3055 166.144 21.0745C166.354 20.8435 166.62 20.665 166.942 20.539C167.271 20.413 167.635 20.329 168.034 20.287C168.433 20.245 168.822 20.224 169.2 20.224V20.14C169.2 19.881 169.109 19.692 168.927 19.573C168.745 19.447 168.521 19.384 168.255 19.384C168.01 19.384 167.772 19.4365 167.541 19.5415C167.317 19.6465 167.124 19.7725 166.963 19.9195L166.092 18.985ZM175.546 23.5V20.644C175.546 20.497 175.532 20.357 175.504 20.224C175.483 20.091 175.444 19.9755 175.388 19.8775C175.332 19.7725 175.252 19.692 175.147 19.636C175.049 19.573 174.923 19.5415 174.769 19.5415C174.615 19.5415 174.478 19.573 174.359 19.636C174.247 19.692 174.153 19.7725 174.076 19.8775C173.999 19.9825 173.939 20.105 173.897 20.245C173.862 20.378 173.845 20.518 173.845 20.665V23.5H172.112V18.271H173.782V18.9955H173.803C173.866 18.8835 173.946 18.775 174.044 18.67C174.149 18.558 174.268 18.4635 174.401 18.3865C174.541 18.3095 174.692 18.2465 174.853 18.1975C175.014 18.1485 175.185 18.124 175.367 18.124C175.717 18.124 176.015 18.187 176.26 18.313C176.505 18.439 176.701 18.6035 176.848 18.8065C177.002 19.0025 177.11 19.23 177.173 19.489C177.243 19.748 177.278 20.007 177.278 20.266V23.5H175.546ZM184.127 23.0065C184.127 23.5175 184.053 23.962 183.906 24.34C183.759 24.718 183.553 25.0295 183.287 25.2745C183.021 25.5265 182.695 25.712 182.31 25.831C181.932 25.957 181.512 26.02 181.05 26.02C180.588 26.02 180.112 25.95 179.622 25.81C179.139 25.67 178.719 25.467 178.362 25.201L179.223 23.9725C179.475 24.1965 179.752 24.361 180.053 24.466C180.361 24.578 180.662 24.634 180.956 24.634C181.46 24.634 181.831 24.501 182.069 24.235C182.314 23.969 182.436 23.6155 182.436 23.1745V22.8595H182.405C182.244 23.0695 182.027 23.2375 181.754 23.3635C181.481 23.4895 181.169 23.5525 180.819 23.5525C180.42 23.5525 180.067 23.4825 179.759 23.3425C179.451 23.1955 179.188 22.9995 178.971 22.7545C178.761 22.5095 178.6 22.226 178.488 21.904C178.376 21.575 178.32 21.2285 178.32 20.8645C178.32 20.5005 178.376 20.154 178.488 19.825C178.6 19.496 178.761 19.2055 178.971 18.9535C179.188 18.7015 179.451 18.502 179.759 18.355C180.067 18.201 180.417 18.124 180.809 18.124C181.138 18.124 181.453 18.1905 181.754 18.3235C182.055 18.4565 182.296 18.663 182.478 18.943H182.499V18.271H184.127V23.0065ZM182.489 20.854C182.489 20.679 182.457 20.511 182.394 20.35C182.338 20.189 182.254 20.049 182.142 19.93C182.03 19.804 181.897 19.706 181.743 19.636C181.589 19.566 181.414 19.531 181.218 19.531C181.022 19.531 180.847 19.566 180.693 19.636C180.546 19.706 180.42 19.8005 180.315 19.9195C180.21 20.0385 180.13 20.1785 180.074 20.3395C180.018 20.5005 179.99 20.672 179.99 20.854C179.99 21.029 180.018 21.197 180.074 21.358C180.13 21.519 180.21 21.6625 180.315 21.7885C180.42 21.9075 180.546 22.0055 180.693 22.0825C180.847 22.1525 181.022 22.1875 181.218 22.1875C181.414 22.1875 181.589 22.1525 181.743 22.0825C181.904 22.0055 182.037 21.9075 182.142 21.7885C182.254 21.6695 182.338 21.5295 182.394 21.3685C182.457 21.2075 182.489 21.036 182.489 20.854ZM189.095 20.287C189.095 20.014 189.008 19.7795 188.833 19.5835C188.665 19.3875 188.409 19.2895 188.066 19.2895C187.898 19.2895 187.744 19.3175 187.604 19.3735C187.464 19.4225 187.342 19.4925 187.237 19.5835C187.132 19.6745 187.048 19.783 186.985 19.909C186.922 20.028 186.887 20.154 186.88 20.287H189.095ZM190.681 20.9485C190.681 21.0185 190.681 21.0885 190.681 21.1585C190.681 21.2285 190.677 21.295 190.67 21.358H186.88C186.894 21.505 186.936 21.638 187.006 21.757C187.083 21.876 187.177 21.981 187.289 22.072C187.408 22.156 187.538 22.2225 187.678 22.2715C187.825 22.3205 187.975 22.345 188.129 22.345C188.402 22.345 188.633 22.296 188.822 22.198C189.011 22.093 189.165 21.96 189.284 21.799L190.481 22.555C190.236 22.912 189.911 23.1885 189.505 23.3845C189.106 23.5735 188.64 23.668 188.108 23.668C187.716 23.668 187.345 23.6085 186.995 23.4895C186.645 23.3635 186.337 23.185 186.071 22.954C185.812 22.716 185.606 22.4255 185.452 22.0825C185.305 21.7395 185.231 21.3475 185.231 20.9065C185.231 20.4795 185.305 20.0945 185.452 19.7515C185.599 19.4015 185.798 19.1075 186.05 18.8695C186.302 18.6245 186.6 18.4355 186.943 18.3025C187.286 18.1695 187.657 18.103 188.056 18.103C188.441 18.103 188.794 18.1695 189.116 18.3025C189.438 18.4285 189.715 18.614 189.946 18.859C190.177 19.104 190.355 19.4015 190.481 19.7515C190.614 20.1015 190.681 20.5005 190.681 20.9485ZM191.77 23.5V15.562H193.513V23.5H191.77ZM200.42 20.8645C200.42 21.2915 200.343 21.68 200.189 22.03C200.035 22.373 199.825 22.667 199.559 22.912C199.293 23.15 198.985 23.3355 198.635 23.4685C198.285 23.6015 197.91 23.668 197.511 23.668C197.119 23.668 196.745 23.6015 196.388 23.4685C196.038 23.3355 195.73 23.15 195.464 22.912C195.205 22.667 194.998 22.373 194.844 22.03C194.69 21.68 194.613 21.2915 194.613 20.8645C194.613 20.4375 194.69 20.0525 194.844 19.7095C194.998 19.3665 195.205 19.076 195.464 18.838C195.73 18.6 196.038 18.418 196.388 18.292C196.745 18.166 197.119 18.103 197.511 18.103C197.91 18.103 198.285 18.166 198.635 18.292C198.985 18.418 199.293 18.6 199.559 18.838C199.825 19.076 200.035 19.3665 200.189 19.7095C200.343 20.0525 200.42 20.4375 200.42 20.8645ZM198.761 20.8645C198.761 20.6965 198.733 20.532 198.677 20.371C198.621 20.21 198.54 20.07 198.435 19.951C198.33 19.825 198.201 19.7235 198.047 19.6465C197.893 19.5695 197.714 19.531 197.511 19.531C197.308 19.531 197.13 19.5695 196.976 19.6465C196.822 19.7235 196.692 19.825 196.587 19.951C196.489 20.07 196.412 20.21 196.356 20.371C196.307 20.532 196.283 20.6965 196.283 20.8645C196.283 21.0325 196.307 21.197 196.356 21.358C196.412 21.519 196.493 21.666 196.598 21.799C196.703 21.925 196.832 22.0265 196.986 22.1035C197.14 22.1805 197.319 22.219 197.522 22.219C197.725 22.219 197.903 22.1805 198.057 22.1035C198.211 22.0265 198.341 21.925 198.446 21.799C198.551 21.666 198.628 21.519 198.677 21.358C198.733 21.197 198.761 21.0325 198.761 20.8645ZM207.054 23.0065C207.054 23.5175 206.981 23.962 206.834 24.34C206.687 24.718 206.48 25.0295 206.214 25.2745C205.948 25.5265 205.623 25.712 205.238 25.831C204.86 25.957 204.44 26.02 203.978 26.02C203.516 26.02 203.04 25.95 202.55 25.81C202.067 25.67 201.647 25.467 201.29 25.201L202.151 23.9725C202.403 24.1965 202.679 24.361 202.98 24.466C203.288 24.578 203.589 24.634 203.883 24.634C204.387 24.634 204.758 24.501 204.996 24.235C205.241 23.969 205.364 23.6155 205.364 23.1745V22.8595H205.332C205.171 23.0695 204.954 23.2375 204.681 23.3635C204.408 23.4895 204.097 23.5525 203.747 23.5525C203.348 23.5525 202.994 23.4825 202.686 23.3425C202.378 23.1955 202.116 22.9995 201.899 22.7545C201.689 22.5095 201.528 22.226 201.416 21.904C201.304 21.575 201.248 21.2285 201.248 20.8645C201.248 20.5005 201.304 20.154 201.416 19.825C201.528 19.496 201.689 19.2055 201.899 18.9535C202.116 18.7015 202.378 18.502 202.686 18.355C202.994 18.201 203.344 18.124 203.736 18.124C204.065 18.124 204.38 18.1905 204.681 18.3235C204.982 18.4565 205.224 18.663 205.406 18.943H205.427V18.271H207.054V23.0065ZM205.416 20.854C205.416 20.679 205.385 20.511 205.322 20.35C205.266 20.189 205.182 20.049 205.07 19.93C204.958 19.804 204.825 19.706 204.671 19.636C204.517 19.566 204.342 19.531 204.146 19.531C203.95 19.531 203.775 19.566 203.621 19.636C203.474 19.706 203.348 19.8005 203.243 19.9195C203.138 20.0385 203.057 20.1785 203.001 20.3395C202.945 20.5005 202.917 20.672 202.917 20.854C202.917 21.029 202.945 21.197 203.001 21.358C203.057 21.519 203.138 21.6625 203.243 21.7885C203.348 21.9075 203.474 22.0055 203.621 22.0825C203.775 22.1525 203.95 22.1875 204.146 22.1875C204.342 22.1875 204.517 22.1525 204.671 22.0825C204.832 22.0055 204.965 21.9075 205.07 21.7885C205.182 21.6695 205.266 21.5295 205.322 21.3685C205.385 21.2075 205.416 21.036 205.416 20.854ZM214.291 16.8325C214.228 16.8115 214.154 16.794 214.07 16.78C213.986 16.766 213.902 16.759 213.818 16.759C213.657 16.759 213.528 16.787 213.43 16.843C213.332 16.899 213.255 16.976 213.199 17.074C213.143 17.165 213.104 17.27 213.083 17.389C213.062 17.508 213.052 17.627 213.052 17.746V18.271H214.217V19.5625H213.052V23.5H211.33V19.5625H210.374V18.271H211.33V17.767C211.33 17.445 211.365 17.1405 211.435 16.8535C211.505 16.5595 211.624 16.304 211.792 16.087C211.967 15.863 212.198 15.688 212.485 15.562C212.779 15.429 213.143 15.3625 213.577 15.3625C213.724 15.3625 213.867 15.373 214.007 15.394C214.154 15.408 214.287 15.4325 214.406 15.4675L214.291 16.8325ZM218.263 19.678C218.186 19.657 218.109 19.643 218.032 19.636C217.962 19.629 217.892 19.6255 217.822 19.6255C217.591 19.6255 217.395 19.6675 217.234 19.7515C217.08 19.8355 216.954 19.937 216.856 20.056C216.765 20.175 216.698 20.3045 216.656 20.4445C216.614 20.5845 216.593 20.707 216.593 20.812V23.5H214.871V18.271H216.53V19.027H216.551C216.684 18.761 216.873 18.544 217.118 18.376C217.363 18.208 217.647 18.124 217.969 18.124C218.039 18.124 218.105 18.1275 218.168 18.1345C218.238 18.1415 218.294 18.152 218.336 18.166L218.263 19.678ZM224.394 20.8645C224.394 21.2915 224.317 21.68 224.163 22.03C224.009 22.373 223.799 22.667 223.533 22.912C223.267 23.15 222.959 23.3355 222.609 23.4685C222.259 23.6015 221.884 23.668 221.485 23.668C221.093 23.668 220.719 23.6015 220.362 23.4685C220.012 23.3355 219.704 23.15 219.438 22.912C219.179 22.667 218.972 22.373 218.818 22.03C218.664 21.68 218.587 21.2915 218.587 20.8645C218.587 20.4375 218.664 20.0525 218.818 19.7095C218.972 19.3665 219.179 19.076 219.438 18.838C219.704 18.6 220.012 18.418 220.362 18.292C220.719 18.166 221.093 18.103 221.485 18.103C221.884 18.103 222.259 18.166 222.609 18.292C222.959 18.418 223.267 18.6 223.533 18.838C223.799 19.076 224.009 19.3665 224.163 19.7095C224.317 20.0525 224.394 20.4375 224.394 20.8645ZM222.735 20.8645C222.735 20.6965 222.707 20.532 222.651 20.371C222.595 20.21 222.514 20.07 222.409 19.951C222.304 19.825 222.175 19.7235 222.021 19.6465C221.867 19.5695 221.688 19.531 221.485 19.531C221.282 19.531 221.104 19.5695 220.95 19.6465C220.796 19.7235 220.666 19.825 220.561 19.951C220.463 20.07 220.386 20.21 220.33 20.371C220.281 20.532 220.257 20.6965 220.257 20.8645C220.257 21.0325 220.281 21.197 220.33 21.358C220.386 21.519 220.467 21.666 220.572 21.799C220.677 21.925 220.806 22.0265 220.96 22.1035C221.114 22.1805 221.293 22.219 221.496 22.219C221.699 22.219 221.877 22.1805 222.031 22.1035C222.185 22.0265 222.315 21.925 222.42 21.799C222.525 21.666 222.602 21.519 222.651 21.358C222.707 21.197 222.735 21.0325 222.735 20.8645ZM232.162 23.5V20.644C232.162 20.497 232.151 20.357 232.13 20.224C232.109 20.084 232.071 19.965 232.015 19.867C231.959 19.769 231.882 19.692 231.784 19.636C231.693 19.573 231.57 19.5415 231.416 19.5415C231.269 19.5415 231.14 19.573 231.028 19.636C230.923 19.699 230.832 19.783 230.755 19.888C230.685 19.993 230.632 20.1155 230.597 20.2555C230.562 20.3885 230.545 20.5285 230.545 20.6755V23.5H228.823V20.518C228.823 20.217 228.763 19.979 228.644 19.804C228.525 19.629 228.336 19.5415 228.077 19.5415C227.804 19.5415 227.591 19.65 227.437 19.867C227.29 20.084 227.216 20.35 227.216 20.665V23.5H225.484V18.271H227.153V18.9955H227.174C227.237 18.8835 227.314 18.775 227.405 18.67C227.503 18.565 227.619 18.474 227.752 18.397C227.885 18.313 228.032 18.2465 228.193 18.1975C228.361 18.1485 228.543 18.124 228.739 18.124C229.117 18.124 229.435 18.201 229.694 18.355C229.96 18.509 230.167 18.7295 230.314 19.0165C230.489 18.7435 230.713 18.5265 230.986 18.3655C231.259 18.2045 231.591 18.124 231.983 18.124C232.34 18.124 232.638 18.1905 232.876 18.3235C233.121 18.4495 233.317 18.6175 233.464 18.8275C233.611 19.0305 233.716 19.2615 233.779 19.5205C233.849 19.7725 233.884 20.021 233.884 20.266V23.5H232.162ZM239.678 17.599V19.132H242.555V20.6125H239.678V23.5H237.904V16.066H242.797V17.599H239.678ZM246.443 21.2215H246.223C246.034 21.2215 245.841 21.232 245.645 21.253C245.456 21.267 245.285 21.2985 245.131 21.3475C244.984 21.3965 244.861 21.47 244.763 21.568C244.665 21.659 244.616 21.7815 244.616 21.9355C244.616 22.0335 244.637 22.1175 244.679 22.1875C244.728 22.2575 244.788 22.3135 244.858 22.3555C244.928 22.3975 245.008 22.429 245.099 22.45C245.19 22.464 245.278 22.471 245.362 22.471C245.712 22.471 245.978 22.3765 246.16 22.1875C246.349 21.9915 246.443 21.729 246.443 21.4V21.2215ZM243.283 18.985C243.591 18.691 243.948 18.4705 244.354 18.3235C244.767 18.1765 245.187 18.103 245.614 18.103C246.055 18.103 246.426 18.159 246.727 18.271C247.035 18.376 247.283 18.544 247.472 18.775C247.661 18.999 247.798 19.286 247.882 19.636C247.973 19.979 248.018 20.3885 248.018 20.8645V23.5H246.443V22.9435H246.412C246.279 23.1605 246.076 23.3285 245.803 23.4475C245.537 23.5665 245.246 23.626 244.931 23.626C244.721 23.626 244.504 23.598 244.28 23.542C244.056 23.486 243.85 23.395 243.661 23.269C243.479 23.143 243.328 22.975 243.209 22.765C243.09 22.555 243.031 22.296 243.031 21.988C243.031 21.61 243.132 21.3055 243.335 21.0745C243.545 20.8435 243.811 20.665 244.133 20.539C244.462 20.413 244.826 20.329 245.225 20.287C245.624 20.245 246.013 20.224 246.391 20.224V20.14C246.391 19.881 246.3 19.692 246.118 19.573C245.936 19.447 245.712 19.384 245.446 19.384C245.201 19.384 244.963 19.4365 244.732 19.5415C244.508 19.6465 244.315 19.7725 244.154 19.9195L243.283 18.985ZM252.38 19.8145C252.24 19.6815 252.076 19.5695 251.887 19.4785C251.698 19.3875 251.498 19.342 251.288 19.342C251.127 19.342 250.977 19.3735 250.837 19.4365C250.704 19.4995 250.637 19.608 250.637 19.762C250.637 19.909 250.711 20.014 250.858 20.077C251.012 20.14 251.257 20.21 251.593 20.287C251.789 20.329 251.985 20.3885 252.181 20.4655C252.384 20.5425 252.566 20.644 252.727 20.77C252.888 20.896 253.017 21.05 253.115 21.232C253.213 21.414 253.262 21.631 253.262 21.883C253.262 22.212 253.196 22.492 253.063 22.723C252.93 22.947 252.755 23.129 252.538 23.269C252.328 23.409 252.09 23.5105 251.824 23.5735C251.558 23.6365 251.292 23.668 251.026 23.668C250.599 23.668 250.179 23.6015 249.766 23.4685C249.36 23.3285 249.02 23.1255 248.747 22.8595L249.713 21.841C249.867 22.009 250.056 22.149 250.28 22.261C250.504 22.373 250.742 22.429 250.994 22.429C251.134 22.429 251.271 22.3975 251.404 22.3345C251.544 22.2645 251.614 22.1455 251.614 21.9775C251.614 21.8165 251.53 21.6975 251.362 21.6205C251.194 21.5435 250.931 21.463 250.574 21.379C250.392 21.337 250.21 21.281 250.028 21.211C249.846 21.141 249.682 21.0465 249.535 20.9275C249.395 20.8085 249.279 20.6615 249.188 20.4865C249.097 20.3115 249.052 20.1015 249.052 19.8565C249.052 19.5415 249.118 19.2755 249.251 19.0585C249.384 18.8345 249.556 18.6525 249.766 18.5125C249.976 18.3725 250.207 18.271 250.459 18.208C250.718 18.138 250.973 18.103 251.225 18.103C251.617 18.103 251.999 18.166 252.37 18.292C252.748 18.411 253.066 18.593 253.325 18.838L252.38 19.8145ZM256.125 19.5625V21.5575C256.125 21.8025 256.171 21.988 256.262 22.114C256.36 22.233 256.531 22.2925 256.776 22.2925C256.86 22.2925 256.948 22.2855 257.039 22.2715C257.137 22.2575 257.217 22.2365 257.28 22.2085L257.301 23.4685C257.182 23.5105 257.032 23.5455 256.85 23.5735C256.668 23.6085 256.486 23.626 256.304 23.626C255.954 23.626 255.66 23.584 255.422 23.5C255.184 23.409 254.991 23.283 254.844 23.122C254.704 22.954 254.603 22.758 254.54 22.534C254.477 22.303 254.445 22.0475 254.445 21.7675V19.5625H253.605V18.271H254.435V16.8955H256.125V18.271H257.354V19.5625H256.125ZM263.298 23.5L262.72 22.0405H259.843L259.297 23.5H257.344L260.463 16.066H262.206L265.293 23.5H263.298ZM261.303 18.0505L260.358 20.602H262.227L261.303 18.0505ZM271.546 18.355C271.546 18.789 271.465 19.1565 271.304 19.4575C271.143 19.7515 270.926 19.9895 270.653 20.1715C270.38 20.3535 270.065 20.4865 269.708 20.5705C269.351 20.6545 268.98 20.6965 268.595 20.6965H267.703V23.5H265.907V16.066H268.637C269.043 16.066 269.421 16.108 269.771 16.192C270.128 16.269 270.436 16.3985 270.695 16.5805C270.961 16.7555 271.168 16.99 271.315 17.284C271.469 17.571 271.546 17.928 271.546 18.355ZM269.75 18.3655C269.75 18.1905 269.715 18.047 269.645 17.935C269.575 17.823 269.481 17.7355 269.362 17.6725C269.243 17.6095 269.106 17.5675 268.952 17.5465C268.805 17.5255 268.651 17.515 268.49 17.515H267.703V19.2685H268.459C268.627 19.2685 268.788 19.2545 268.942 19.2265C269.096 19.1985 269.232 19.1495 269.351 19.0795C269.477 19.0095 269.575 18.9185 269.645 18.8065C269.715 18.6875 269.75 18.5405 269.75 18.3655ZM272.623 23.5V16.066H274.429V23.5H272.623Z" fill="#F9FAFB"/>
+</g>
+<defs>
+<filter id="filter0_f_12187_586" x="-30" y="-30" width="360" height="100" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="15" result="effect1_foregroundBlur_12187_586"/>
+</filter>
+<radialGradient id="paint0_radial_12187_586" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(140 15.8) rotate(-173.561) scale(140.889 24.7295)">
+<stop stop-color="#4A144B"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint1_radial_12187_586" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(14.7115 6.35417) rotate(63.815) scale(41.7282 73.8399)">
+<stop stop-color="#4C50BB"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint2_radial_12187_586" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(230.625 29.8) rotate(-129.994) scale(38.8978 240.228)">
+<stop stop-color="#FF8585"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<linearGradient id="paint3_linear_12187_586" x1="4.6577" y1="-0.383822" x2="15.3281" y2="79.6444" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="0.21875" stop-color="white"/>
+<stop offset="0.416667" stop-color="#015CD5"/>
+<stop offset="0.625" stop-color="#2E303E"/>
+<stop offset="0.864583" stop-color="#19AEFF"/>
+</linearGradient>
+<linearGradient id="paint4_linear_12187_586" x1="31.487" y1="16.397" x2="36.6985" y2="16.397" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="1" stop-color="#015CD5"/>
+</linearGradient>
+<clipPath id="clip0_12187_586">
+<rect width="300" height="40" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/en/docs/img/sponsors/bump-sh.png b/docs/en/docs/img/sponsors/bump-sh.png
new file mode 100755
index 000000000..61817e86f
Binary files /dev/null and b/docs/en/docs/img/sponsors/bump-sh.png differ
diff --git a/docs/en/docs/img/sponsors/bump-sh.svg b/docs/en/docs/img/sponsors/bump-sh.svg
new file mode 100644
index 000000000..053e54b1d
--- /dev/null
+++ b/docs/en/docs/img/sponsors/bump-sh.svg
@@ -0,0 +1,56 @@
+<svg width="240" height="100" viewBox="0 0 240 100" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_12161_3932)">
+<rect width="240" height="100" fill="#2E303E"/>
+<g opacity="0.3" filter="url(#filter0_f_12161_3932)">
+<rect width="240" height="100" fill="url(#paint0_radial_12161_3932)"/>
+<rect width="240" height="100" fill="url(#paint1_radial_12161_3932)"/>
+<rect width="240" height="100" fill="url(#paint2_radial_12161_3932)"/>
+</g>
+<rect x="0.1" y="0.1" width="239.8" height="99.8" rx="15.9" stroke="url(#paint3_linear_12161_3932)" stroke-opacity="0.2" stroke-width="0.2"/>
+<path d="M24.54 54.14C24.54 54.7187 24.4327 55.2087 24.218 55.61C24.0033 56.002 23.714 56.3193 23.35 56.562C22.986 56.8047 22.566 56.982 22.09 57.094C21.614 57.206 21.1193 57.262 20.606 57.262H19.416V61H17.022V51.088H20.662C21.2033 51.088 21.7073 51.144 22.174 51.256C22.65 51.3587 23.0607 51.5313 23.406 51.774C23.7607 52.0073 24.036 52.32 24.232 52.712C24.4373 53.0947 24.54 53.5707 24.54 54.14ZM22.146 54.154C22.146 53.9207 22.0993 53.7293 22.006 53.58C21.9127 53.4307 21.7867 53.314 21.628 53.23C21.4693 53.146 21.2873 53.09 21.082 53.062C20.886 53.034 20.6807 53.02 20.466 53.02H19.416V55.358H20.424C20.648 55.358 20.8627 55.3393 21.068 55.302C21.2733 55.2647 21.4553 55.1993 21.614 55.106C21.782 55.0127 21.9127 54.8913 22.006 54.742C22.0993 54.5833 22.146 54.3873 22.146 54.154ZM29.8415 61V60.034H29.8135C29.7295 60.1927 29.6175 60.342 29.4775 60.482C29.3468 60.622 29.1882 60.7433 29.0015 60.846C28.8242 60.9487 28.6235 61.0327 28.3995 61.098C28.1848 61.1633 27.9562 61.196 27.7135 61.196C27.2468 61.196 26.8502 61.112 26.5235 60.944C26.2062 60.776 25.9448 60.5613 25.7395 60.3C25.5435 60.0293 25.3988 59.726 25.3055 59.39C25.2215 59.0447 25.1795 58.6947 25.1795 58.34V54.028H27.4895V57.808C27.4895 58.004 27.5035 58.1907 27.5315 58.368C27.5595 58.5453 27.6108 58.704 27.6855 58.844C27.7695 58.984 27.8768 59.096 28.0075 59.18C28.1382 59.2547 28.3108 59.292 28.5255 59.292C28.9268 59.292 29.2302 59.1427 29.4355 58.844C29.6502 58.5453 29.7575 58.1953 29.7575 57.794V54.028H32.0535V61H29.8415ZM41.6191 57.486C41.6191 57.9713 41.5445 58.438 41.3951 58.886C41.2458 59.334 41.0265 59.7307 40.7371 60.076C40.4571 60.412 40.1118 60.6827 39.7011 60.888C39.2905 61.0933 38.8238 61.196 38.3011 61.196C37.8345 61.196 37.3911 61.1027 36.9711 60.916C36.5605 60.72 36.2431 60.4447 36.0191 60.09H35.9911V61H33.8771V50.416H36.1731V54.77H36.2011C36.3971 54.5367 36.6725 54.322 37.0271 54.126C37.3818 53.93 37.8158 53.832 38.3291 53.832C38.8331 53.832 39.2858 53.93 39.6871 54.126C40.0978 54.322 40.4431 54.588 40.7231 54.924C41.0125 55.26 41.2318 55.652 41.3811 56.1C41.5398 56.5387 41.6191 57.0007 41.6191 57.486ZM39.4071 57.486C39.4071 57.262 39.3698 57.0427 39.2951 56.828C39.2298 56.6133 39.1271 56.4267 38.9871 56.268C38.8471 56.1 38.6745 55.9647 38.4691 55.862C38.2638 55.7593 38.0258 55.708 37.7551 55.708C37.4938 55.708 37.2605 55.7593 37.0551 55.862C36.8498 55.9647 36.6725 56.1 36.5231 56.268C36.3831 56.436 36.2711 56.6273 36.1871 56.842C36.1125 57.0567 36.0751 57.276 36.0751 57.5C36.0751 57.724 36.1125 57.9433 36.1871 58.158C36.2711 58.3727 36.3831 58.564 36.5231 58.732C36.6725 58.9 36.8498 59.0353 37.0551 59.138C37.2605 59.2407 37.4938 59.292 37.7551 59.292C38.0258 59.292 38.2638 59.2407 38.4691 59.138C38.6745 59.0353 38.8471 58.9 38.9871 58.732C39.1271 58.564 39.2298 58.3727 39.2951 58.158C39.3698 57.934 39.4071 57.71 39.4071 57.486ZM43.1056 61V50.416H45.4296V61H43.1056ZM49.7396 51.802C49.7396 51.9793 49.7022 52.1473 49.6276 52.306C49.5622 52.4553 49.4689 52.586 49.3476 52.698C49.2356 52.81 49.0956 52.8987 48.9276 52.964C48.7689 53.0293 48.6009 53.062 48.4236 53.062C48.0502 53.062 47.7376 52.9407 47.4856 52.698C47.2336 52.446 47.1076 52.1473 47.1076 51.802C47.1076 51.634 47.1402 51.4753 47.2056 51.326C47.2709 51.1673 47.3642 51.032 47.4856 50.92C47.6069 50.808 47.7469 50.7193 47.9056 50.654C48.0642 50.5793 48.2369 50.542 48.4236 50.542C48.6009 50.542 48.7689 50.5747 48.9276 50.64C49.0956 50.7053 49.2356 50.794 49.3476 50.906C49.4689 51.018 49.5622 51.1533 49.6276 51.312C49.7022 51.4613 49.7396 51.6247 49.7396 51.802ZM47.2756 61V54.028H49.5716V61H47.2756ZM55.4921 56.086C55.3055 55.9087 55.0861 55.7593 54.8341 55.638C54.5821 55.5167 54.3161 55.456 54.0361 55.456C53.8215 55.456 53.6208 55.498 53.4341 55.582C53.2568 55.666 53.1681 55.8107 53.1681 56.016C53.1681 56.212 53.2661 56.352 53.4621 56.436C53.6675 56.52 53.9941 56.6133 54.4421 56.716C54.7035 56.772 54.9648 56.8513 55.2261 56.954C55.4968 57.0567 55.7395 57.192 55.9541 57.36C56.1688 57.528 56.3415 57.7333 56.4721 57.976C56.6028 58.2187 56.6681 58.508 56.6681 58.844C56.6681 59.2827 56.5795 59.656 56.4021 59.964C56.2248 60.2627 55.9915 60.5053 55.7021 60.692C55.4221 60.8787 55.1048 61.014 54.7501 61.098C54.3955 61.182 54.0408 61.224 53.6861 61.224C53.1168 61.224 52.5568 61.1353 52.0061 60.958C51.4648 60.7713 51.0121 60.5007 50.6481 60.146L51.9361 58.788C52.1415 59.012 52.3935 59.1987 52.6921 59.348C52.9908 59.4973 53.3081 59.572 53.6441 59.572C53.8308 59.572 54.0128 59.53 54.1901 59.446C54.3768 59.3527 54.4701 59.194 54.4701 58.97C54.4701 58.7553 54.3581 58.5967 54.1341 58.494C53.9101 58.3913 53.5601 58.284 53.0841 58.172C52.8415 58.116 52.5988 58.0413 52.3561 57.948C52.1135 57.8547 51.8941 57.7287 51.6981 57.57C51.5115 57.4113 51.3575 57.2153 51.2361 56.982C51.1148 56.7487 51.0541 56.4687 51.0541 56.142C51.0541 55.722 51.1428 55.3673 51.3201 55.078C51.4975 54.7793 51.7261 54.5367 52.0061 54.35C52.2861 54.1633 52.5941 54.028 52.9301 53.944C53.2755 53.8507 53.6161 53.804 53.9521 53.804C54.4748 53.804 54.9835 53.888 55.4781 54.056C55.9821 54.2147 56.4068 54.4573 56.7521 54.784L55.4921 56.086ZM62.5857 61V57.22C62.5857 57.024 62.5717 56.8373 62.5437 56.66C62.5157 56.4827 62.4597 56.3287 62.3757 56.198C62.301 56.058 62.1983 55.9507 62.0677 55.876C61.937 55.792 61.769 55.75 61.5637 55.75C61.1623 55.75 60.8543 55.8947 60.6397 56.184C60.425 56.464 60.3177 56.814 60.3177 57.234V61H58.0217V50.416H60.3177V54.91H60.3457C60.5043 54.63 60.7563 54.3827 61.1017 54.168C61.447 53.944 61.8623 53.832 62.3477 53.832C62.8237 53.832 63.2203 53.916 63.5377 54.084C63.8643 54.252 64.1257 54.4713 64.3217 54.742C64.527 55.0033 64.6717 55.3067 64.7557 55.652C64.849 55.9973 64.8957 56.3427 64.8957 56.688V61H62.5857ZM76.7342 61L75.9642 59.054H72.1282L71.4002 61H68.7962L72.9542 51.088H75.2782L79.3942 61H76.7342ZM74.0742 53.734L72.8142 57.136H75.3062L74.0742 53.734ZM87.7314 54.14C87.7314 54.7187 87.6241 55.2087 87.4094 55.61C87.1947 56.002 86.9054 56.3193 86.5414 56.562C86.1774 56.8047 85.7574 56.982 85.2814 57.094C84.8054 57.206 84.3107 57.262 83.7974 57.262H82.6074V61H80.2134V51.088H83.8534C84.3947 51.088 84.8987 51.144 85.3654 51.256C85.8414 51.3587 86.2521 51.5313 86.5974 51.774C86.9521 52.0073 87.2274 52.32 87.4234 52.712C87.6287 53.0947 87.7314 53.5707 87.7314 54.14ZM85.3374 54.154C85.3374 53.9207 85.2907 53.7293 85.1974 53.58C85.1041 53.4307 84.9781 53.314 84.8194 53.23C84.6607 53.146 84.4787 53.09 84.2734 53.062C84.0774 53.034 83.8721 53.02 83.6574 53.02H82.6074V55.358H83.6154C83.8394 55.358 84.0541 55.3393 84.2594 55.302C84.4647 55.2647 84.6467 55.1993 84.8054 55.106C84.9734 55.0127 85.1041 54.8913 85.1974 54.742C85.2907 54.5833 85.3374 54.3873 85.3374 54.154ZM89.1685 61V51.088H91.5765V61H89.1685ZM102.278 61V60.09H102.25C102.026 60.4447 101.704 60.72 101.284 60.916C100.873 61.1027 100.434 61.196 99.9675 61.196C99.4448 61.196 98.9782 61.0933 98.5675 60.888C98.1568 60.6827 97.8068 60.412 97.5175 60.076C97.2375 59.7307 97.0228 59.334 96.8735 58.886C96.7242 58.438 96.6495 57.9713 96.6495 57.486C96.6495 57.0007 96.7242 56.5387 96.8735 56.1C97.0322 55.652 97.2515 55.26 97.5315 54.924C97.8208 54.588 98.1662 54.322 98.5675 54.126C98.9782 53.93 99.4355 53.832 99.9395 53.832C100.453 53.832 100.887 53.93 101.242 54.126C101.596 54.322 101.872 54.5367 102.068 54.77H102.096V50.416H104.392V61H102.278ZM102.194 57.5C102.194 57.276 102.152 57.0567 102.068 56.842C101.993 56.6273 101.881 56.436 101.732 56.268C101.592 56.1 101.419 55.9647 101.214 55.862C101.008 55.7593 100.775 55.708 100.514 55.708C100.243 55.708 100.005 55.7593 99.7995 55.862C99.5942 55.9647 99.4215 56.1 99.2815 56.268C99.1415 56.4267 99.0342 56.6133 98.9595 56.828C98.8942 57.0427 98.8615 57.262 98.8615 57.486C98.8615 57.71 98.8942 57.934 98.9595 58.158C99.0342 58.3727 99.1415 58.564 99.2815 58.732C99.4215 58.9 99.5942 59.0353 99.7995 59.138C100.005 59.2407 100.243 59.292 100.514 59.292C100.775 59.292 101.008 59.2407 101.214 59.138C101.419 59.0353 101.592 58.9 101.732 58.732C101.881 58.564 101.993 58.3727 102.068 58.158C102.152 57.9433 102.194 57.724 102.194 57.5ZM113.606 57.486C113.606 58.0553 113.504 58.5733 113.298 59.04C113.093 59.4973 112.813 59.8893 112.458 60.216C112.104 60.5333 111.693 60.7807 111.226 60.958C110.76 61.1353 110.26 61.224 109.728 61.224C109.206 61.224 108.706 61.1353 108.23 60.958C107.764 60.7807 107.353 60.5333 106.998 60.216C106.653 59.8893 106.378 59.4973 106.172 59.04C105.967 58.5733 105.864 58.0553 105.864 57.486C105.864 56.9167 105.967 56.4033 106.172 55.946C106.378 55.4887 106.653 55.1013 106.998 54.784C107.353 54.4667 107.764 54.224 108.23 54.056C108.706 53.888 109.206 53.804 109.728 53.804C110.26 53.804 110.76 53.888 111.226 54.056C111.693 54.224 112.104 54.4667 112.458 54.784C112.813 55.1013 113.093 55.4887 113.298 55.946C113.504 56.4033 113.606 56.9167 113.606 57.486ZM111.394 57.486C111.394 57.262 111.357 57.0427 111.282 56.828C111.208 56.6133 111.1 56.4267 110.96 56.268C110.82 56.1 110.648 55.9647 110.442 55.862C110.237 55.7593 109.999 55.708 109.728 55.708C109.458 55.708 109.22 55.7593 109.014 55.862C108.809 55.9647 108.636 56.1 108.496 56.268C108.366 56.4267 108.263 56.6133 108.188 56.828C108.123 57.0427 108.09 57.262 108.09 57.486C108.09 57.71 108.123 57.9293 108.188 58.144C108.263 58.3587 108.37 58.5547 108.51 58.732C108.65 58.9 108.823 59.0353 109.028 59.138C109.234 59.2407 109.472 59.292 109.742 59.292C110.013 59.292 110.251 59.2407 110.456 59.138C110.662 59.0353 110.834 58.9 110.974 58.732C111.114 58.5547 111.217 58.3587 111.282 58.144C111.357 57.9293 111.394 57.71 111.394 57.486ZM119.862 56.282C119.731 56.114 119.554 55.9787 119.33 55.876C119.106 55.7733 118.877 55.722 118.644 55.722C118.401 55.722 118.182 55.7733 117.986 55.876C117.79 55.9693 117.622 56.1 117.482 56.268C117.342 56.4267 117.23 56.6133 117.146 56.828C117.071 57.0427 117.034 57.2713 117.034 57.514C117.034 57.7567 117.071 57.9853 117.146 58.2C117.221 58.4147 117.328 58.606 117.468 58.774C117.617 58.9327 117.79 59.0587 117.986 59.152C118.191 59.2453 118.42 59.292 118.672 59.292C118.905 59.292 119.134 59.25 119.358 59.166C119.591 59.0727 119.778 58.942 119.918 58.774L121.192 60.328C120.903 60.608 120.529 60.8273 120.072 60.986C119.615 61.1447 119.129 61.224 118.616 61.224C118.065 61.224 117.552 61.14 117.076 60.972C116.6 60.804 116.185 60.5613 115.83 60.244C115.485 59.9173 115.209 59.5253 115.004 59.068C114.808 58.6107 114.71 58.0927 114.71 57.514C114.71 56.9447 114.808 56.4313 115.004 55.974C115.209 55.5167 115.485 55.1293 115.83 54.812C116.185 54.4853 116.6 54.238 117.076 54.07C117.552 53.8927 118.061 53.804 118.602 53.804C118.854 53.804 119.101 53.8273 119.344 53.874C119.596 53.9207 119.834 53.986 120.058 54.07C120.291 54.1447 120.501 54.2427 120.688 54.364C120.884 54.476 121.052 54.602 121.192 54.742L119.862 56.282ZM126.203 56.086C126.016 55.9087 125.797 55.7593 125.545 55.638C125.293 55.5167 125.027 55.456 124.747 55.456C124.532 55.456 124.332 55.498 124.145 55.582C123.968 55.666 123.879 55.8107 123.879 56.016C123.879 56.212 123.977 56.352 124.173 56.436C124.378 56.52 124.705 56.6133 125.153 56.716C125.414 56.772 125.676 56.8513 125.937 56.954C126.208 57.0567 126.45 57.192 126.665 57.36C126.88 57.528 127.052 57.7333 127.183 57.976C127.314 58.2187 127.379 58.508 127.379 58.844C127.379 59.2827 127.29 59.656 127.113 59.964C126.936 60.2627 126.702 60.5053 126.413 60.692C126.133 60.8787 125.816 61.014 125.461 61.098C125.106 61.182 124.752 61.224 124.397 61.224C123.828 61.224 123.268 61.1353 122.717 60.958C122.176 60.7713 121.723 60.5007 121.359 60.146L122.647 58.788C122.852 59.012 123.104 59.1987 123.403 59.348C123.702 59.4973 124.019 59.572 124.355 59.572C124.542 59.572 124.724 59.53 124.901 59.446C125.088 59.3527 125.181 59.194 125.181 58.97C125.181 58.7553 125.069 58.5967 124.845 58.494C124.621 58.3913 124.271 58.284 123.795 58.172C123.552 58.116 123.31 58.0413 123.067 57.948C122.824 57.8547 122.605 57.7287 122.409 57.57C122.222 57.4113 122.068 57.2153 121.947 56.982C121.826 56.7487 121.765 56.4687 121.765 56.142C121.765 55.722 121.854 55.3673 122.031 55.078C122.208 54.7793 122.437 54.5367 122.717 54.35C122.997 54.1633 123.305 54.028 123.641 53.944C123.986 53.8507 124.327 53.804 124.663 53.804C125.186 53.804 125.694 53.888 126.189 54.056C126.693 54.2147 127.118 54.4573 127.463 54.784L126.203 56.086ZM136.321 57.962H136.027C135.775 57.962 135.518 57.976 135.257 58.004C135.005 58.0227 134.776 58.0647 134.571 58.13C134.375 58.1953 134.211 58.2933 134.081 58.424C133.95 58.5453 133.885 58.7087 133.885 58.914C133.885 59.0447 133.913 59.1567 133.969 59.25C134.034 59.3433 134.113 59.418 134.207 59.474C134.3 59.53 134.407 59.572 134.529 59.6C134.65 59.6187 134.767 59.628 134.879 59.628C135.345 59.628 135.7 59.502 135.943 59.25C136.195 58.9887 136.321 58.6387 136.321 58.2V57.962ZM132.107 54.98C132.517 54.588 132.993 54.294 133.535 54.098C134.085 53.902 134.645 53.804 135.215 53.804C135.803 53.804 136.297 53.8787 136.699 54.028C137.109 54.168 137.441 54.392 137.693 54.7C137.945 54.9987 138.127 55.3813 138.239 55.848C138.36 56.3053 138.421 56.8513 138.421 57.486V61H136.321V60.258H136.279C136.101 60.5473 135.831 60.7713 135.467 60.93C135.112 61.0887 134.725 61.168 134.305 61.168C134.025 61.168 133.735 61.1307 133.437 61.056C133.138 60.9813 132.863 60.86 132.611 60.692C132.368 60.524 132.167 60.3 132.009 60.02C131.85 59.74 131.771 59.3947 131.771 58.984C131.771 58.48 131.906 58.074 132.177 57.766C132.457 57.458 132.811 57.22 133.241 57.052C133.679 56.884 134.165 56.772 134.697 56.716C135.229 56.66 135.747 56.632 136.251 56.632V56.52C136.251 56.1747 136.129 55.9227 135.887 55.764C135.644 55.596 135.345 55.512 134.991 55.512C134.664 55.512 134.347 55.582 134.039 55.722C133.74 55.862 133.483 56.03 133.269 56.226L132.107 54.98ZM144.712 61V57.192C144.712 56.996 144.694 56.8093 144.656 56.632C144.628 56.4547 144.577 56.3007 144.502 56.17C144.428 56.03 144.32 55.9227 144.18 55.848C144.05 55.764 143.882 55.722 143.676 55.722C143.471 55.722 143.289 55.764 143.13 55.848C142.981 55.9227 142.855 56.03 142.752 56.17C142.65 56.31 142.57 56.4733 142.514 56.66C142.468 56.8373 142.444 57.024 142.444 57.22V61H140.134V54.028H142.36V54.994H142.388C142.472 54.8447 142.58 54.7 142.71 54.56C142.85 54.4107 143.009 54.2847 143.186 54.182C143.373 54.0793 143.574 53.9953 143.788 53.93C144.003 53.8647 144.232 53.832 144.474 53.832C144.941 53.832 145.338 53.916 145.664 54.084C145.991 54.252 146.252 54.4713 146.448 54.742C146.654 55.0033 146.798 55.3067 146.882 55.652C146.976 55.9973 147.022 56.3427 147.022 56.688V61H144.712ZM154.039 61V60.09H154.011C153.787 60.4447 153.465 60.72 153.045 60.916C152.635 61.1027 152.196 61.196 151.729 61.196C151.207 61.196 150.74 61.0933 150.329 60.888C149.919 60.6827 149.569 60.412 149.279 60.076C148.999 59.7307 148.785 59.334 148.635 58.886C148.486 58.438 148.411 57.9713 148.411 57.486C148.411 57.0007 148.486 56.5387 148.635 56.1C148.794 55.652 149.013 55.26 149.293 54.924C149.583 54.588 149.928 54.322 150.329 54.126C150.74 53.93 151.197 53.832 151.701 53.832C152.215 53.832 152.649 53.93 153.003 54.126C153.358 54.322 153.633 54.5367 153.829 54.77H153.857V50.416H156.153V61H154.039ZM153.955 57.5C153.955 57.276 153.913 57.0567 153.829 56.842C153.755 56.6273 153.643 56.436 153.493 56.268C153.353 56.1 153.181 55.9647 152.975 55.862C152.77 55.7593 152.537 55.708 152.275 55.708C152.005 55.708 151.767 55.7593 151.561 55.862C151.356 55.9647 151.183 56.1 151.043 56.268C150.903 56.4267 150.796 56.6133 150.721 56.828C150.656 57.0427 150.623 57.262 150.623 57.486C150.623 57.71 150.656 57.934 150.721 58.158C150.796 58.3727 150.903 58.564 151.043 58.732C151.183 58.9 151.356 59.0353 151.561 59.138C151.767 59.2407 152.005 59.292 152.275 59.292C152.537 59.292 152.77 59.2407 152.975 59.138C153.181 59.0353 153.353 58.9 153.493 58.732C153.643 58.564 153.755 58.3727 153.829 58.158C153.913 57.9433 153.955 57.724 153.955 57.5ZM21.698 78.282C21.5673 78.114 21.39 77.9787 21.166 77.876C20.942 77.7733 20.7133 77.722 20.48 77.722C20.2373 77.722 20.018 77.7733 19.822 77.876C19.626 77.9693 19.458 78.1 19.318 78.268C19.178 78.4267 19.066 78.6133 18.982 78.828C18.9073 79.0427 18.87 79.2713 18.87 79.514C18.87 79.7567 18.9073 79.9853 18.982 80.2C19.0567 80.4147 19.164 80.606 19.304 80.774C19.4533 80.9327 19.626 81.0587 19.822 81.152C20.0273 81.2453 20.256 81.292 20.508 81.292C20.7413 81.292 20.97 81.25 21.194 81.166C21.4273 81.0727 21.614 80.942 21.754 80.774L23.028 82.328C22.7387 82.608 22.3653 82.8273 21.908 82.986C21.4507 83.1447 20.9653 83.224 20.452 83.224C19.9013 83.224 19.388 83.14 18.912 82.972C18.436 82.804 18.0207 82.5613 17.666 82.244C17.3207 81.9173 17.0453 81.5253 16.84 81.068C16.644 80.6107 16.546 80.0927 16.546 79.514C16.546 78.9447 16.644 78.4313 16.84 77.974C17.0453 77.5167 17.3207 77.1293 17.666 76.812C18.0207 76.4853 18.436 76.238 18.912 76.07C19.388 75.8927 19.8967 75.804 20.438 75.804C20.69 75.804 20.9373 75.8273 21.18 75.874C21.432 75.9207 21.67 75.986 21.894 76.07C22.1273 76.1447 22.3373 76.2427 22.524 76.364C22.72 76.476 22.888 76.602 23.028 76.742L21.698 78.282ZM28.529 83V79.22C28.529 79.024 28.515 78.8373 28.487 78.66C28.459 78.4827 28.403 78.3287 28.319 78.198C28.2443 78.058 28.1417 77.9507 28.011 77.876C27.8803 77.792 27.7123 77.75 27.507 77.75C27.1057 77.75 26.7977 77.8947 26.583 78.184C26.3683 78.464 26.261 78.814 26.261 79.234V83H23.965V72.416H26.261V76.91H26.289C26.4477 76.63 26.6997 76.3827 27.045 76.168C27.3903 75.944 27.8057 75.832 28.291 75.832C28.767 75.832 29.1637 75.916 29.481 76.084C29.8077 76.252 30.069 76.4713 30.265 76.742C30.4703 77.0033 30.615 77.3067 30.699 77.652C30.7923 77.9973 30.839 78.3427 30.839 78.688V83H28.529ZM36.6936 79.962H36.3996C36.1476 79.962 35.891 79.976 35.6296 80.004C35.3776 80.0227 35.149 80.0647 34.9436 80.13C34.7476 80.1953 34.5843 80.2933 34.4536 80.424C34.323 80.5453 34.2576 80.7087 34.2576 80.914C34.2576 81.0447 34.2856 81.1567 34.3416 81.25C34.407 81.3433 34.4863 81.418 34.5796 81.474C34.673 81.53 34.7803 81.572 34.9016 81.6C35.023 81.6187 35.1396 81.628 35.2516 81.628C35.7183 81.628 36.073 81.502 36.3156 81.25C36.5676 80.9887 36.6936 80.6387 36.6936 80.2V79.962ZM32.4796 76.98C32.8903 76.588 33.3663 76.294 33.9076 76.098C34.4583 75.902 35.0183 75.804 35.5876 75.804C36.1756 75.804 36.6703 75.8787 37.0716 76.028C37.4823 76.168 37.8136 76.392 38.0656 76.7C38.3176 76.9987 38.4996 77.3813 38.6116 77.848C38.733 78.3053 38.7936 78.8513 38.7936 79.486V83H36.6936V82.258H36.6516C36.4743 82.5473 36.2036 82.7713 35.8396 82.93C35.485 83.0887 35.0976 83.168 34.6776 83.168C34.3976 83.168 34.1083 83.1307 33.8096 83.056C33.511 82.9813 33.2356 82.86 32.9836 82.692C32.741 82.524 32.5403 82.3 32.3816 82.02C32.223 81.74 32.1436 81.3947 32.1436 80.984C32.1436 80.48 32.279 80.074 32.5496 79.766C32.8296 79.458 33.1843 79.22 33.6136 79.052C34.0523 78.884 34.5376 78.772 35.0696 78.716C35.6016 78.66 36.1196 78.632 36.6236 78.632V78.52C36.6236 78.1747 36.5023 77.9227 36.2596 77.764C36.017 77.596 35.7183 77.512 35.3636 77.512C35.037 77.512 34.7196 77.582 34.4116 77.722C34.113 77.862 33.8563 78.03 33.6416 78.226L32.4796 76.98ZM45.0853 83V79.192C45.0853 78.996 45.0667 78.8093 45.0293 78.632C45.0013 78.4547 44.95 78.3007 44.8753 78.17C44.8007 78.03 44.6933 77.9227 44.5533 77.848C44.4227 77.764 44.2547 77.722 44.0493 77.722C43.844 77.722 43.662 77.764 43.5033 77.848C43.354 77.9227 43.228 78.03 43.1253 78.17C43.0227 78.31 42.9433 78.4733 42.8873 78.66C42.8407 78.8373 42.8173 79.024 42.8173 79.22V83H40.5073V76.028H42.7333V76.994H42.7613C42.8453 76.8447 42.9527 76.7 43.0833 76.56C43.2233 76.4107 43.382 76.2847 43.5593 76.182C43.746 76.0793 43.9467 75.9953 44.1613 75.93C44.376 75.8647 44.6047 75.832 44.8473 75.832C45.314 75.832 45.7107 75.916 46.0373 76.084C46.364 76.252 46.6253 76.4713 46.8213 76.742C47.0267 77.0033 47.1713 77.3067 47.2553 77.652C47.3487 77.9973 47.3953 78.3427 47.3953 78.688V83H45.0853ZM56.5263 82.342C56.5263 83.0233 56.4283 83.616 56.2323 84.12C56.0363 84.624 55.7609 85.0393 55.4063 85.366C55.0516 85.702 54.6176 85.9493 54.1043 86.108C53.6003 86.276 53.0403 86.36 52.4243 86.36C51.8083 86.36 51.1736 86.2667 50.5203 86.08C49.8763 85.8933 49.3163 85.6227 48.8403 85.268L49.9883 83.63C50.3243 83.9287 50.6929 84.148 51.0943 84.288C51.5049 84.4373 51.9063 84.512 52.2983 84.512C52.9703 84.512 53.4649 84.3347 53.7823 83.98C54.1089 83.6253 54.2723 83.154 54.2723 82.566V82.146H54.2303C54.0156 82.426 53.7263 82.65 53.3623 82.818C52.9983 82.986 52.5829 83.07 52.1163 83.07C51.5843 83.07 51.1129 82.9767 50.7023 82.79C50.2916 82.594 49.9416 82.3327 49.6523 82.006C49.3723 81.6793 49.1576 81.3013 49.0083 80.872C48.8589 80.4333 48.7843 79.9713 48.7843 79.486C48.7843 79.0007 48.8589 78.5387 49.0083 78.1C49.1576 77.6613 49.3723 77.274 49.6523 76.938C49.9416 76.602 50.2916 76.336 50.7023 76.14C51.1129 75.9347 51.5796 75.832 52.1023 75.832C52.5409 75.832 52.9609 75.9207 53.3623 76.098C53.7636 76.2753 54.0856 76.5507 54.3283 76.924H54.3563V76.028H56.5263V82.342ZM54.3423 79.472C54.3423 79.2387 54.3003 79.0147 54.2163 78.8C54.1416 78.5853 54.0296 78.3987 53.8803 78.24C53.7309 78.072 53.5536 77.9413 53.3483 77.848C53.1429 77.7547 52.9096 77.708 52.6483 77.708C52.3869 77.708 52.1536 77.7547 51.9483 77.848C51.7523 77.9413 51.5843 78.0673 51.4443 78.226C51.3043 78.3847 51.1969 78.5713 51.1223 78.786C51.0476 79.0007 51.0103 79.2293 51.0103 79.472C51.0103 79.7053 51.0476 79.9293 51.1223 80.144C51.1969 80.3587 51.3043 80.55 51.4443 80.718C51.5843 80.8767 51.7523 81.0073 51.9483 81.11C52.1536 81.2033 52.3869 81.25 52.6483 81.25C52.9096 81.25 53.1429 81.2033 53.3483 81.11C53.5629 81.0073 53.7403 80.8767 53.8803 80.718C54.0296 80.5593 54.1416 80.3727 54.2163 80.158C54.3003 79.9433 54.3423 79.7147 54.3423 79.472ZM63.1511 78.716C63.1511 78.352 63.0345 78.0393 62.8011 77.778C62.5771 77.5167 62.2365 77.386 61.7791 77.386C61.5551 77.386 61.3498 77.4233 61.1631 77.498C60.9765 77.5633 60.8131 77.6567 60.6731 77.778C60.5331 77.8993 60.4211 78.044 60.3371 78.212C60.2531 78.3707 60.2065 78.5387 60.1971 78.716H63.1511ZM65.2651 79.598C65.2651 79.6913 65.2651 79.7847 65.2651 79.878C65.2651 79.9713 65.2605 80.06 65.2511 80.144H60.1971C60.2158 80.34 60.2718 80.5173 60.3651 80.676C60.4678 80.8347 60.5938 80.9747 60.7431 81.096C60.9018 81.208 61.0745 81.2967 61.2611 81.362C61.4571 81.4273 61.6578 81.46 61.8631 81.46C62.2271 81.46 62.5351 81.3947 62.7871 81.264C63.0391 81.124 63.2445 80.9467 63.4031 80.732L64.9991 81.74C64.6725 82.216 64.2385 82.5847 63.6971 82.846C63.1651 83.098 62.5445 83.224 61.8351 83.224C61.3125 83.224 60.8178 83.1447 60.3511 82.986C59.8845 82.818 59.4738 82.58 59.1191 82.272C58.7738 81.9547 58.4985 81.5673 58.2931 81.11C58.0971 80.6527 57.9991 80.13 57.9991 79.542C57.9991 78.9727 58.0971 78.4593 58.2931 78.002C58.4891 77.5353 58.7551 77.1433 59.0911 76.826C59.4271 76.4993 59.8238 76.2473 60.2811 76.07C60.7385 75.8927 61.2331 75.804 61.7651 75.804C62.2785 75.804 62.7498 75.8927 63.1791 76.07C63.6085 76.238 63.9771 76.4853 64.2851 76.812C64.5931 77.1387 64.8311 77.5353 64.9991 78.002C65.1765 78.4687 65.2651 79.0007 65.2651 79.598ZM66.717 83V72.416H69.041V83H66.717ZM78.2509 79.486C78.2509 80.0553 78.1482 80.5733 77.9429 81.04C77.7376 81.4973 77.4576 81.8893 77.1029 82.216C76.7482 82.5333 76.3376 82.7807 75.8709 82.958C75.4042 83.1353 74.9049 83.224 74.3729 83.224C73.8502 83.224 73.3509 83.1353 72.8749 82.958C72.4082 82.7807 71.9976 82.5333 71.6429 82.216C71.2976 81.8893 71.0222 81.4973 70.8169 81.04C70.6116 80.5733 70.5089 80.0553 70.5089 79.486C70.5089 78.9167 70.6116 78.4033 70.8169 77.946C71.0222 77.4887 71.2976 77.1013 71.6429 76.784C71.9976 76.4667 72.4082 76.224 72.8749 76.056C73.3509 75.888 73.8502 75.804 74.3729 75.804C74.9049 75.804 75.4042 75.888 75.8709 76.056C76.3376 76.224 76.7482 76.4667 77.1029 76.784C77.4576 77.1013 77.7376 77.4887 77.9429 77.946C78.1482 78.4033 78.2509 78.9167 78.2509 79.486ZM76.0389 79.486C76.0389 79.262 76.0016 79.0427 75.9269 78.828C75.8522 78.6133 75.7449 78.4267 75.6049 78.268C75.4649 78.1 75.2922 77.9647 75.0869 77.862C74.8816 77.7593 74.6436 77.708 74.3729 77.708C74.1022 77.708 73.8642 77.7593 73.6589 77.862C73.4536 77.9647 73.2809 78.1 73.1409 78.268C73.0102 78.4267 72.9076 78.6133 72.8329 78.828C72.7676 79.0427 72.7349 79.262 72.7349 79.486C72.7349 79.71 72.7676 79.9293 72.8329 80.144C72.9076 80.3587 73.0149 80.5547 73.1549 80.732C73.2949 80.9 73.4676 81.0353 73.6729 81.138C73.8782 81.2407 74.1162 81.292 74.3869 81.292C74.6576 81.292 74.8956 81.2407 75.1009 81.138C75.3062 81.0353 75.4789 80.9 75.6189 80.732C75.7589 80.5547 75.8616 80.3587 75.9269 80.144C76.0016 79.9293 76.0389 79.71 76.0389 79.486ZM87.0966 82.342C87.0966 83.0233 86.9986 83.616 86.8026 84.12C86.6066 84.624 86.3313 85.0393 85.9766 85.366C85.6219 85.702 85.1879 85.9493 84.6746 86.108C84.1706 86.276 83.6106 86.36 82.9946 86.36C82.3786 86.36 81.7439 86.2667 81.0906 86.08C80.4466 85.8933 79.8866 85.6227 79.4106 85.268L80.5586 83.63C80.8946 83.9287 81.2633 84.148 81.6646 84.288C82.0753 84.4373 82.4766 84.512 82.8686 84.512C83.5406 84.512 84.0353 84.3347 84.3526 83.98C84.6793 83.6253 84.8426 83.154 84.8426 82.566V82.146H84.8006C84.5859 82.426 84.2966 82.65 83.9326 82.818C83.5686 82.986 83.1533 83.07 82.6866 83.07C82.1546 83.07 81.6833 82.9767 81.2726 82.79C80.8619 82.594 80.5119 82.3327 80.2226 82.006C79.9426 81.6793 79.7279 81.3013 79.5786 80.872C79.4293 80.4333 79.3546 79.9713 79.3546 79.486C79.3546 79.0007 79.4293 78.5387 79.5786 78.1C79.7279 77.6613 79.9426 77.274 80.2226 76.938C80.5119 76.602 80.8619 76.336 81.2726 76.14C81.6833 75.9347 82.1499 75.832 82.6726 75.832C83.1113 75.832 83.5313 75.9207 83.9326 76.098C84.3339 76.2753 84.6559 76.5507 84.8986 76.924H84.9266V76.028H87.0966V82.342ZM84.9126 79.472C84.9126 79.2387 84.8706 79.0147 84.7866 78.8C84.7119 78.5853 84.5999 78.3987 84.4506 78.24C84.3013 78.072 84.1239 77.9413 83.9186 77.848C83.7133 77.7547 83.4799 77.708 83.2186 77.708C82.9573 77.708 82.7239 77.7547 82.5186 77.848C82.3226 77.9413 82.1546 78.0673 82.0146 78.226C81.8746 78.3847 81.7673 78.5713 81.6926 78.786C81.6179 79.0007 81.5806 79.2293 81.5806 79.472C81.5806 79.7053 81.6179 79.9293 81.6926 80.144C81.7673 80.3587 81.8746 80.55 82.0146 80.718C82.1546 80.8767 82.3226 81.0073 82.5186 81.11C82.7239 81.2033 82.9573 81.25 83.2186 81.25C83.4799 81.25 83.7133 81.2033 83.9186 81.11C84.1333 81.0073 84.3106 80.8767 84.4506 80.718C84.5999 80.5593 84.7119 80.3727 84.7866 80.158C84.8706 79.9433 84.9126 79.7147 84.9126 79.472ZM96.7454 74.11C96.6614 74.082 96.5634 74.0587 96.4514 74.04C96.3394 74.0213 96.2274 74.012 96.1154 74.012C95.9008 74.012 95.7281 74.0493 95.5974 74.124C95.4668 74.1987 95.3641 74.3013 95.2894 74.432C95.2148 74.5533 95.1634 74.6933 95.1354 74.852C95.1074 75.0107 95.0934 75.1693 95.0934 75.328V76.028H96.6474V77.75H95.0934V83H92.7974V77.75H91.5234V76.028H92.7974V75.356C92.7974 74.9267 92.8441 74.5207 92.9374 74.138C93.0308 73.746 93.1894 73.4053 93.4134 73.116C93.6468 72.8173 93.9548 72.584 94.3374 72.416C94.7294 72.2387 95.2148 72.15 95.7934 72.15C95.9894 72.15 96.1808 72.164 96.3674 72.192C96.5634 72.2107 96.7408 72.2433 96.8994 72.29L96.7454 74.11ZM102.041 77.904C101.938 77.876 101.836 77.8573 101.733 77.848C101.64 77.8387 101.546 77.834 101.453 77.834C101.145 77.834 100.884 77.89 100.669 78.002C100.464 78.114 100.296 78.2493 100.165 78.408C100.044 78.5667 99.955 78.7393 99.899 78.926C99.843 79.1127 99.815 79.276 99.815 79.416V83H97.519V76.028H99.731V77.036H99.759C99.9364 76.6813 100.188 76.392 100.515 76.168C100.842 75.944 101.22 75.832 101.649 75.832C101.742 75.832 101.831 75.8367 101.915 75.846C102.008 75.8553 102.083 75.8693 102.139 75.888L102.041 77.904ZM110.216 79.486C110.216 80.0553 110.113 80.5733 109.908 81.04C109.702 81.4973 109.422 81.8893 109.068 82.216C108.713 82.5333 108.302 82.7807 107.836 82.958C107.369 83.1353 106.87 83.224 106.338 83.224C105.815 83.224 105.316 83.1353 104.84 82.958C104.373 82.7807 103.962 82.5333 103.608 82.216C103.262 81.8893 102.987 81.4973 102.782 81.04C102.576 80.5733 102.474 80.0553 102.474 79.486C102.474 78.9167 102.576 78.4033 102.782 77.946C102.987 77.4887 103.262 77.1013 103.608 76.784C103.962 76.4667 104.373 76.224 104.84 76.056C105.316 75.888 105.815 75.804 106.338 75.804C106.87 75.804 107.369 75.888 107.836 76.056C108.302 76.224 108.713 76.4667 109.068 76.784C109.422 77.1013 109.702 77.4887 109.908 77.946C110.113 78.4033 110.216 78.9167 110.216 79.486ZM108.004 79.486C108.004 79.262 107.966 79.0427 107.892 78.828C107.817 78.6133 107.71 78.4267 107.57 78.268C107.43 78.1 107.257 77.9647 107.052 77.862C106.846 77.7593 106.608 77.708 106.338 77.708C106.067 77.708 105.829 77.7593 105.624 77.862C105.418 77.9647 105.246 78.1 105.106 78.268C104.975 78.4267 104.872 78.6133 104.798 78.828C104.732 79.0427 104.7 79.262 104.7 79.486C104.7 79.71 104.732 79.9293 104.798 80.144C104.872 80.3587 104.98 80.5547 105.12 80.732C105.26 80.9 105.432 81.0353 105.638 81.138C105.843 81.2407 106.081 81.292 106.352 81.292C106.622 81.292 106.86 81.2407 107.066 81.138C107.271 81.0353 107.444 80.9 107.584 80.732C107.724 80.5547 107.826 80.3587 107.892 80.144C107.966 79.9293 108.004 79.71 108.004 79.486ZM120.573 83V79.192C120.573 78.996 120.559 78.8093 120.531 78.632C120.503 78.4453 120.452 78.2867 120.377 78.156C120.303 78.0253 120.2 77.9227 120.069 77.848C119.948 77.764 119.785 77.722 119.579 77.722C119.383 77.722 119.211 77.764 119.061 77.848C118.921 77.932 118.8 78.044 118.697 78.184C118.604 78.324 118.534 78.4873 118.487 78.674C118.441 78.8513 118.417 79.038 118.417 79.234V83H116.121V79.024C116.121 78.6227 116.042 78.3053 115.883 78.072C115.725 77.8387 115.473 77.722 115.127 77.722C114.763 77.722 114.479 77.8667 114.273 78.156C114.077 78.4453 113.979 78.8 113.979 79.22V83H111.669V76.028H113.895V76.994H113.923C114.007 76.8447 114.11 76.7 114.231 76.56C114.362 76.42 114.516 76.2987 114.693 76.196C114.871 76.084 115.067 75.9953 115.281 75.93C115.505 75.8647 115.748 75.832 116.009 75.832C116.513 75.832 116.938 75.9347 117.283 76.14C117.638 76.3453 117.913 76.6393 118.109 77.022C118.343 76.658 118.641 76.3687 119.005 76.154C119.369 75.9393 119.813 75.832 120.335 75.832C120.811 75.832 121.208 75.9207 121.525 76.098C121.852 76.266 122.113 76.49 122.309 76.77C122.505 77.0407 122.645 77.3487 122.729 77.694C122.823 78.03 122.869 78.3613 122.869 78.688V83H120.573ZM130.595 75.132V77.176H134.431V79.15H130.595V83H128.229V73.088H134.753V75.132H130.595ZM139.616 79.962H139.322C139.07 79.962 138.813 79.976 138.552 80.004C138.3 80.0227 138.071 80.0647 137.866 80.13C137.67 80.1953 137.506 80.2933 137.376 80.424C137.245 80.5453 137.18 80.7087 137.18 80.914C137.18 81.0447 137.208 81.1567 137.264 81.25C137.329 81.3433 137.408 81.418 137.502 81.474C137.595 81.53 137.702 81.572 137.824 81.6C137.945 81.6187 138.062 81.628 138.174 81.628C138.64 81.628 138.995 81.502 139.238 81.25C139.49 80.9887 139.616 80.6387 139.616 80.2V79.962ZM135.402 76.98C135.812 76.588 136.288 76.294 136.83 76.098C137.38 75.902 137.94 75.804 138.51 75.804C139.098 75.804 139.592 75.8787 139.994 76.028C140.404 76.168 140.736 76.392 140.988 76.7C141.24 76.9987 141.422 77.3813 141.534 77.848C141.655 78.3053 141.716 78.8513 141.716 79.486V83H139.616V82.258H139.574C139.396 82.5473 139.126 82.7713 138.762 82.93C138.407 83.0887 138.02 83.168 137.6 83.168C137.32 83.168 137.03 83.1307 136.732 83.056C136.433 82.9813 136.158 82.86 135.906 82.692C135.663 82.524 135.462 82.3 135.304 82.02C135.145 81.74 135.066 81.3947 135.066 80.984C135.066 80.48 135.201 80.074 135.472 79.766C135.752 79.458 136.106 79.22 136.536 79.052C136.974 78.884 137.46 78.772 137.992 78.716C138.524 78.66 139.042 78.632 139.546 78.632V78.52C139.546 78.1747 139.424 77.9227 139.182 77.764C138.939 77.596 138.64 77.512 138.286 77.512C137.959 77.512 137.642 77.582 137.334 77.722C137.035 77.862 136.778 78.03 136.564 78.226L135.402 76.98ZM147.531 78.086C147.345 77.9087 147.125 77.7593 146.873 77.638C146.621 77.5167 146.355 77.456 146.075 77.456C145.861 77.456 145.66 77.498 145.473 77.582C145.296 77.666 145.207 77.8107 145.207 78.016C145.207 78.212 145.305 78.352 145.501 78.436C145.707 78.52 146.033 78.6133 146.481 78.716C146.743 78.772 147.004 78.8513 147.265 78.954C147.536 79.0567 147.779 79.192 147.993 79.36C148.208 79.528 148.381 79.7333 148.511 79.976C148.642 80.2187 148.707 80.508 148.707 80.844C148.707 81.2827 148.619 81.656 148.441 81.964C148.264 82.2627 148.031 82.5053 147.741 82.692C147.461 82.8787 147.144 83.014 146.789 83.098C146.435 83.182 146.08 83.224 145.725 83.224C145.156 83.224 144.596 83.1353 144.045 82.958C143.504 82.7713 143.051 82.5007 142.687 82.146L143.975 80.788C144.181 81.012 144.433 81.1987 144.731 81.348C145.03 81.4973 145.347 81.572 145.683 81.572C145.87 81.572 146.052 81.53 146.229 81.446C146.416 81.3527 146.509 81.194 146.509 80.97C146.509 80.7553 146.397 80.5967 146.173 80.494C145.949 80.3913 145.599 80.284 145.123 80.172C144.881 80.116 144.638 80.0413 144.395 79.948C144.153 79.8547 143.933 79.7287 143.737 79.57C143.551 79.4113 143.397 79.2153 143.275 78.982C143.154 78.7487 143.093 78.4687 143.093 78.142C143.093 77.722 143.182 77.3673 143.359 77.078C143.537 76.7793 143.765 76.5367 144.045 76.35C144.325 76.1633 144.633 76.028 144.969 75.944C145.315 75.8507 145.655 75.804 145.991 75.804C146.514 75.804 147.023 75.888 147.517 76.056C148.021 76.2147 148.446 76.4573 148.791 76.784L147.531 78.086ZM152.525 77.75V80.41C152.525 80.7367 152.585 80.984 152.707 81.152C152.837 81.3107 153.066 81.39 153.393 81.39C153.505 81.39 153.621 81.3807 153.743 81.362C153.873 81.3433 153.981 81.3153 154.065 81.278L154.093 82.958C153.934 83.014 153.733 83.0607 153.491 83.098C153.248 83.1447 153.005 83.168 152.763 83.168C152.296 83.168 151.904 83.112 151.587 83C151.269 82.8787 151.013 82.7107 150.817 82.496C150.63 82.272 150.495 82.0107 150.411 81.712C150.327 81.404 150.285 81.0633 150.285 80.69V77.75H149.165V76.028H150.271V74.194H152.525V76.028H154.163V77.75H152.525ZM162.088 83L161.318 81.054H157.482L156.754 83H154.15L158.308 73.088H160.632L164.748 83H162.088ZM159.428 75.734L158.168 79.136H160.66L159.428 75.734ZM173.085 76.14C173.085 76.7187 172.978 77.2087 172.763 77.61C172.548 78.002 172.259 78.3193 171.895 78.562C171.531 78.8047 171.111 78.982 170.635 79.094C170.159 79.206 169.664 79.262 169.151 79.262H167.961V83H165.567V73.088H169.207C169.748 73.088 170.252 73.144 170.719 73.256C171.195 73.3587 171.606 73.5313 171.951 73.774C172.306 74.0073 172.581 74.32 172.777 74.712C172.982 75.0947 173.085 75.5707 173.085 76.14ZM170.691 76.154C170.691 75.9207 170.644 75.7293 170.551 75.58C170.458 75.4307 170.332 75.314 170.173 75.23C170.014 75.146 169.832 75.09 169.627 75.062C169.431 75.034 169.226 75.02 169.011 75.02H167.961V77.358H168.969C169.193 77.358 169.408 77.3393 169.613 77.302C169.818 77.2647 170 77.1993 170.159 77.106C170.327 77.0127 170.458 76.8913 170.551 76.742C170.644 76.5833 170.691 76.3873 170.691 76.154ZM174.522 83V73.088H176.93V83H174.522Z" fill="#F9FAFB"/>
+<path d="M26.3653 23.9009C27.7965 23.9009 28.9567 25.052 28.9567 26.4719C28.9567 27.8918 27.7965 29.0429 26.3653 29.0429L16 29.0429L16 23.9009L26.3653 23.9009Z" fill="white"/>
+<path d="M19.4551 17.0449C20.8863 17.0449 22.0464 18.196 22.0464 19.6159C22.0464 21.0358 20.8863 22.1869 19.4551 22.1869L16 22.1869L16 17.0449L19.4551 17.0449Z" fill="white"/>
+<path d="M42.3033 22.8708C42.997 22.7504 44.0029 21.9588 44.0029 20.4962C44.0029 18.5689 42.6674 17.2955 40.5688 17.2955L34.8453 17.2955L34.8453 28.8247L40.5861 28.8247C43.1704 28.8247 44.3325 27.4997 44.3325 25.6241C44.3325 23.9893 43.2571 23.0601 42.3033 22.9397L42.3033 22.8708ZM37.2041 19.2916L40.3086 19.2916C41.0718 19.2916 41.7135 19.8251 41.7135 20.6338C41.7135 21.5286 41.0891 22.1137 40.1526 22.1137L37.2041 22.1137L37.2041 19.2916ZM37.2041 26.8286L37.2041 23.9721L40.4127 23.9721C41.2972 23.9721 41.9216 24.5228 41.9216 25.4004C41.9216 26.2607 41.3839 26.8286 40.326 26.8286L37.2041 26.8286Z" fill="white"/>
+<path d="M54.0172 20.238L51.7279 20.238L51.7279 24.0409C51.7279 26.1403 50.8779 27.0007 49.5773 27.0007C48.5192 27.0007 47.8255 26.1919 47.8255 24.9874L47.8255 20.238L45.5361 20.238L45.5361 25.4692C45.5361 27.6029 46.9236 29.0828 49.0049 29.0828C50.1494 29.0828 51.0515 28.7214 51.7279 28.0503L51.7279 28.8247L54.0172 28.8247L54.0172 20.238Z" fill="white"/>
+<path d="M66.9767 19.98C65.5892 19.98 64.5311 20.5134 63.82 21.391C63.1956 20.479 62.1378 19.98 60.9757 19.98C59.8485 19.98 58.9987 20.3414 58.3916 20.9436L58.3916 20.2381L56.1021 20.2381L56.1021 28.8248L58.3916 28.8248L58.3916 24.6949C58.3916 22.8881 59.1547 22.0621 60.3686 22.0621C61.3227 22.0621 62.0684 22.7676 62.0684 23.9206L62.0684 28.8248L64.3578 28.8248L64.3578 24.6949C64.3578 22.8881 65.1555 22.0621 66.3697 22.0621C67.3235 22.0621 68.0693 22.7676 68.0693 23.9206L68.0693 28.8248L70.3415 28.8248L70.3415 23.4559C70.3415 21.3566 68.7804 19.98 66.9767 19.98Z" fill="white"/>
+<path d="M77.3695 19.98C76.1901 19.98 75.2363 20.3241 74.5078 20.9264L74.5078 20.2381L72.2183 20.2381L72.2183 31.7501L74.5078 31.7501L74.5078 28.1537C75.2363 28.7387 76.1901 29.0829 77.3695 29.0829C79.5722 29.0829 81.6188 27.2416 81.6188 24.54C81.6188 21.8384 79.5722 19.98 77.3695 19.98ZM76.9705 27.104C75.739 27.104 74.5078 26.1231 74.5078 24.54C74.5078 22.9569 75.739 21.9589 76.9705 21.9589C78.358 21.9589 79.3988 22.9569 79.3988 24.54C79.3988 26.1231 78.358 27.104 76.9705 27.104Z" fill="white"/>
+<path d="M92.2518 22.97C92.0673 22.7285 91.8136 22.5214 91.4908 22.3489C91.1679 22.1649 90.8163 22.0729 90.4357 22.0729C90.1014 22.0729 89.7958 22.1419 89.5191 22.2799C89.2423 22.4179 89.104 22.6479 89.104 22.97C89.104 23.292 89.2539 23.5221 89.5537 23.6601C89.865 23.7866 90.3147 23.9189 90.9027 24.0569C91.2141 24.1259 91.5254 24.2179 91.8367 24.3329C92.1596 24.448 92.4478 24.6032 92.7015 24.7988C92.9667 24.9828 93.18 25.2186 93.3414 25.5061C93.5029 25.7821 93.5836 26.1214 93.5836 26.524C93.5836 27.0301 93.4856 27.4614 93.2895 27.8179C93.1051 28.163 92.8514 28.4448 92.5285 28.6633C92.2172 28.8818 91.8482 29.0371 91.4216 29.1291C91.0065 29.2326 90.5741 29.2844 90.1244 29.2844C89.4787 29.2844 88.8503 29.1694 88.2392 28.9393C87.6281 28.6978 87.1207 28.3585 86.7172 27.9215L88.0835 26.6448C88.3141 26.9438 88.6139 27.1911 88.9829 27.3866C89.3519 27.5822 89.7612 27.6799 90.2109 27.6799C90.3608 27.6799 90.5107 27.6627 90.6606 27.6282C90.822 27.5937 90.9661 27.5419 91.093 27.4729C91.2314 27.3924 91.3409 27.2889 91.4216 27.1623C91.5023 27.0358 91.5427 26.8806 91.5427 26.6965C91.5427 26.3515 91.3812 26.1042 91.0584 25.9547C90.7471 25.8051 90.2743 25.6556 89.6401 25.5061C89.3288 25.4371 89.0233 25.3508 88.7235 25.2473C88.4352 25.1323 88.1758 24.9885 87.9452 24.816C87.7146 24.632 87.5301 24.4077 87.3917 24.1432C87.2533 23.8786 87.1841 23.5508 87.1841 23.1598C87.1841 22.6997 87.2764 22.3029 87.4609 21.9693C87.6569 21.6358 87.9106 21.3655 88.2219 21.1585C88.5332 20.94 88.8849 20.7789 89.2769 20.6754C89.669 20.5719 90.0725 20.5201 90.4876 20.5201C91.0872 20.5201 91.6695 20.6237 92.2345 20.8307C92.811 21.0377 93.2665 21.354 93.6009 21.7796L92.2518 22.97Z" fill="white"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M92.2266 23.2259L92.1122 23.0761C91.9457 22.8581 91.713 22.6663 91.4079 22.5032L91.4058 22.5021L91.4037 22.5009C91.108 22.3324 90.7864 22.2479 90.4357 22.2479C90.1263 22.2479 89.8479 22.3116 89.5975 22.4365C89.4844 22.4929 89.4077 22.5637 89.3581 22.646C89.3083 22.7289 89.2794 22.8344 89.2794 22.9701C89.2794 23.1032 89.31 23.2068 89.3634 23.2888C89.4165 23.3702 89.4996 23.4419 89.6236 23.4996C89.9221 23.6205 90.3598 23.7498 90.9418 23.8864C91.2605 23.9571 91.5788 24.0512 91.8966 24.1685C92.2338 24.2888 92.5371 24.4516 92.8052 24.6577C93.0907 24.8566 93.3204 25.1111 93.4937 25.4194C93.6738 25.728 93.759 26.0991 93.759 26.5241C93.759 27.0521 93.6567 27.5136 93.4438 27.9013C93.2462 28.2704 92.9739 28.5731 92.6282 28.8074C92.296 29.0403 91.9059 29.2034 91.4614 29.2996C91.0325 29.4064 90.5867 29.4595 90.1244 29.4595C89.4573 29.4595 88.8079 29.3405 88.1772 29.1032L88.1759 29.1026L88.1745 29.1021C87.5414 28.8519 87.0113 28.4984 86.5881 28.0401L86.4702 27.9124L88.1047 26.3853L88.2225 26.5381C88.4363 26.8154 88.716 27.0471 89.0652 27.2322C89.4069 27.4132 89.7876 27.505 90.2109 27.505C90.3471 27.505 90.4838 27.4893 90.6211 27.4577L90.6224 27.4574L90.6238 27.4571C90.77 27.4259 90.8971 27.3798 91.0067 27.3205C91.1215 27.2533 91.2092 27.1693 91.2735 27.0685C91.3327 26.9758 91.3672 26.8549 91.3672 26.6966C91.3672 26.5521 91.3337 26.4385 91.2745 26.3478C91.2151 26.2568 91.1222 26.1772 90.9845 26.1135L90.9833 26.113L90.9822 26.1124C90.6885 25.9713 90.2309 25.8254 89.6009 25.6768C89.2835 25.6063 88.9718 25.5184 88.666 25.4128L88.6621 25.4114L88.6583 25.4099C88.3568 25.2896 88.0837 25.1385 87.8399 24.9561L87.8377 24.9544L87.8355 24.9527C87.5856 24.7533 87.3856 24.51 87.2361 24.2242C87.0813 23.9281 87.0087 23.5706 87.0087 23.1598C87.0087 22.6763 87.1057 22.2492 87.3072 21.8849L87.3083 21.8829L87.3095 21.8809C87.5181 21.526 87.7893 21.2363 88.1227 21.0142C88.4516 20.7836 88.8219 20.6146 89.232 20.5063C89.639 20.3988 90.0577 20.3452 90.4876 20.3452C91.1077 20.3452 91.7103 20.4523 92.2944 20.6663C92.8976 20.883 93.3817 21.2171 93.7389 21.6717L93.8409 21.8015L92.2266 23.2259ZM88.2218 21.1586C87.9105 21.3656 87.6569 21.6359 87.4608 21.9694C87.2763 22.303 87.1841 22.6998 87.1841 23.1598C87.1841 23.5509 87.2533 23.8787 87.3917 24.1432C87.53 24.4078 87.7145 24.6321 87.9451 24.8161C88.1757 24.9886 88.4352 25.1324 88.7234 25.2474C89.0232 25.3509 89.3288 25.4372 89.6401 25.5062C90.2743 25.6557 90.747 25.8052 91.0583 25.9547C91.3812 26.1043 91.5426 26.3515 91.5426 26.6966C91.5426 26.8806 91.5023 27.0359 91.4216 27.1624C91.3408 27.2889 91.2313 27.3924 91.0929 27.473C90.9661 27.542 90.822 27.5937 90.6605 27.6282C90.5106 27.6627 90.3608 27.68 90.2109 27.68C89.7612 27.68 89.3518 27.5822 88.9829 27.3867C88.671 27.2214 88.4085 27.0192 88.1955 26.78C88.1565 26.7362 88.1192 26.6911 88.0835 26.6448L86.7171 27.9215C86.7313 27.9369 86.7456 27.9521 86.76 27.9672C86.7859 27.9943 86.8122 28.0211 86.839 28.0474C87.2213 28.4243 87.688 28.7216 88.2391 28.9394C88.8503 29.1695 89.4787 29.2845 90.1244 29.2845C90.5741 29.2845 91.0065 29.2327 91.4216 29.1292C91.8482 29.0372 92.2172 28.8819 92.5285 28.6634C92.8513 28.4449 93.105 28.1631 93.2895 27.818C93.4855 27.4615 93.5835 27.0301 93.5835 26.5241C93.5835 26.1215 93.5028 25.7822 93.3414 25.5062C93.18 25.2186 92.9666 24.9829 92.7014 24.7988C92.4478 24.6033 92.1595 24.448 91.8367 24.333C91.5253 24.218 91.214 24.126 90.9027 24.057C90.3146 23.919 89.8649 23.7867 89.5536 23.6602C89.2538 23.5221 89.1039 23.2921 89.1039 22.9701C89.1039 22.648 89.2423 22.418 89.519 22.28C89.7958 22.1419 90.1013 22.0729 90.4357 22.0729C90.8162 22.0729 91.1679 22.165 91.4907 22.349C91.7522 22.4887 91.9682 22.651 92.1389 22.836C92.1791 22.8794 92.2167 22.9241 92.2517 22.9701L93.6008 21.7796C93.2664 21.3541 92.811 21.0378 92.2345 20.8308C91.6695 20.6237 91.0872 20.5202 90.4876 20.5202C90.0725 20.5202 89.6689 20.572 89.2769 20.6755C88.8848 20.779 88.5332 20.94 88.2218 21.1586Z" fill="white"/>
+<path d="M28.9566 19.6159C28.9566 21.0358 27.7964 22.1869 26.3653 22.1869C24.9341 22.1869 23.7739 21.0358 23.7739 19.6159C23.7739 18.196 24.9341 17.0449 26.3653 17.0449C27.7964 17.0449 28.9566 18.196 28.9566 19.6159Z" fill="url(#paint4_linear_12161_3932)"/>
+<path d="M82.4836 27.8352C82.4836 27.4671 82.6162 27.1508 82.8814 26.8863C83.1582 26.6218 83.4868 26.4895 83.8673 26.4895C84.2363 26.4895 84.5591 26.616 84.8359 26.8691C85.1126 27.1221 85.251 27.4326 85.251 27.8007C85.251 28.1687 85.1126 28.485 84.8359 28.7496C84.5707 29.0141 84.2478 29.1464 83.8673 29.1464C83.6828 29.1464 83.5041 29.1119 83.3311 29.0429C83.1697 28.9739 83.0256 28.8818 82.8987 28.7668C82.7719 28.6518 82.6681 28.5138 82.5874 28.3528C82.5182 28.1917 82.4836 28.0192 82.4836 27.8352Z" fill="white"/>
+<path d="M95.5586 29.0429L97.8483 29.0429L97.8483 24.913C97.8483 23.1062 98.6461 22.2803 99.8602 22.2803C100.814 22.2803 101.56 22.9858 101.56 24.1387L101.56 29.0429L103.832 29.0429L103.832 23.6741C103.832 21.5747 102.271 20.1981 100.467 20.1981C99.3924 20.1981 98.5153 20.5182 97.844 21.0705L97.844 16L95.5586 16L95.5586 29.0429Z" fill="white"/>
+</g>
+<defs>
+<filter id="filter0_f_12161_3932" x="-30" y="-30" width="300" height="160" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="15" result="effect1_foregroundBlur_12161_3932"/>
+</filter>
+<radialGradient id="paint0_radial_12161_3932" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(112 39.5) rotate(-160.573) scale(118.761 58.6742)">
+<stop stop-color="#4A144B"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint1_radial_12161_3932" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(11.7692 15.8854) rotate(81.0575) scale(94.7665 65.0274)">
+<stop stop-color="#4C50BB"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint2_radial_12161_3932" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(184.5 74.5) rotate(-105.027) scale(77.1379 242.277)">
+<stop stop-color="#FF8585"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<linearGradient id="paint3_linear_12161_3932" x1="3.72616" y1="-0.959555" x2="76.0199" y2="172.545" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="0.21875" stop-color="white"/>
+<stop offset="0.416667" stop-color="#015CD5"/>
+<stop offset="0.625" stop-color="#2E303E"/>
+<stop offset="0.864583" stop-color="#19AEFF"/>
+</linearGradient>
+<linearGradient id="paint4_linear_12161_3932" x1="23.7893" y1="19.5513" x2="29.066" y2="19.5513" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="1" stop-color="#015CD5"/>
+</linearGradient>
+<clipPath id="clip0_12161_3932">
+<rect width="240" height="100" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/en/docs/img/sponsors/fern-banner.png b/docs/en/docs/img/sponsors/fern-banner.png
new file mode 100644
index 000000000..1b70ab96d
Binary files /dev/null and b/docs/en/docs/img/sponsors/fern-banner.png differ
diff --git a/docs/en/docs/img/sponsors/fern-banner.svg b/docs/en/docs/img/sponsors/fern-banner.svg
new file mode 100644
index 000000000..e05ccc3a4
--- /dev/null
+++ b/docs/en/docs/img/sponsors/fern-banner.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="300" zoomAndPan="magnify" viewBox="0 0 224.87999 30.000001" height="40" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><g/><clipPath id="ef5ae8abd8"><path d="M 3.570312 0 L 221.195312 0 L 221.195312 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " clip-rule="nonzero"/></clipPath><clipPath id="16c6c08de4"><path d="M 13 7 L 29 7 L 29 28.839844 L 13 28.839844 Z M 13 7 " clip-rule="nonzero"/></clipPath></defs><g clip-path="url(#ef5ae8abd8)"><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 36.289062 L 3.570312 36.289062 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/></g><g fill="#000000" fill-opacity="1"><g transform="translate(92.004145, 10.887099)"><g><path d="M 3.6875 0.109375 C 3.050781 0.109375 2.5 -0.0351562 2.03125 -0.328125 C 1.570312 -0.617188 1.21875 -1.054688 0.96875 -1.640625 C 0.71875 -2.222656 0.59375 -2.941406 0.59375 -3.796875 C 0.59375 -4.660156 0.742188 -5.382812 1.046875 -5.96875 C 1.347656 -6.550781 1.765625 -6.984375 2.296875 -7.265625 C 2.835938 -7.554688 3.460938 -7.703125 4.171875 -7.703125 C 4.898438 -7.703125 5.519531 -7.566406 6.03125 -7.296875 C 6.539062 -7.023438 6.898438 -6.625 7.109375 -6.09375 L 6.015625 -5.421875 L 5.875 -5.4375 C 5.71875 -5.769531 5.5 -6.015625 5.21875 -6.171875 C 4.9375 -6.328125 4.585938 -6.40625 4.171875 -6.40625 C 3.515625 -6.40625 3.007812 -6.195312 2.65625 -5.78125 C 2.3125 -5.375 2.140625 -4.710938 2.140625 -3.796875 C 2.140625 -2.878906 2.300781 -2.210938 2.625 -1.796875 C 2.957031 -1.378906 3.4375 -1.171875 4.0625 -1.171875 C 4.613281 -1.171875 5.019531 -1.289062 5.28125 -1.53125 C 5.539062 -1.78125 5.671875 -2.148438 5.671875 -2.640625 L 5.671875 -2.96875 L 3.875 -2.96875 L 3.875 -4.1875 L 7.15625 -4.1875 L 7.15625 0 L 5.71875 0 L 5.71875 -1.015625 L 5.609375 -1.03125 C 5.453125 -0.664062 5.21875 -0.382812 4.90625 -0.1875 C 4.59375 0.0078125 4.1875 0.109375 3.6875 0.109375 Z M 3.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(99.92521, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(106.152985, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(112.863815, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(119.09159, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(123.584522, 10.887099)"><g><path d="M 2.234375 0.109375 C 1.867188 0.109375 1.550781 0.0390625 1.28125 -0.09375 C 1.007812 -0.226562 0.800781 -0.425781 0.65625 -0.6875 C 0.507812 -0.945312 0.4375 -1.257812 0.4375 -1.625 C 0.4375 -1.96875 0.507812 -2.253906 0.65625 -2.484375 C 0.800781 -2.710938 1.023438 -2.898438 1.328125 -3.046875 C 1.628906 -3.191406 2.03125 -3.304688 2.53125 -3.390625 C 2.875 -3.441406 3.132812 -3.5 3.3125 -3.5625 C 3.488281 -3.632812 3.609375 -3.710938 3.671875 -3.796875 C 3.734375 -3.878906 3.765625 -3.984375 3.765625 -4.109375 C 3.765625 -4.296875 3.695312 -4.4375 3.5625 -4.53125 C 3.4375 -4.632812 3.226562 -4.6875 2.9375 -4.6875 C 2.613281 -4.6875 2.304688 -4.613281 2.015625 -4.46875 C 1.734375 -4.320312 1.484375 -4.132812 1.265625 -3.90625 L 1.171875 -3.90625 L 0.5625 -4.8125 C 0.851562 -5.132812 1.207031 -5.382812 1.625 -5.5625 C 2.050781 -5.75 2.507812 -5.84375 3 -5.84375 C 3.757812 -5.84375 4.304688 -5.679688 4.640625 -5.359375 C 4.984375 -5.035156 5.15625 -4.578125 5.15625 -3.984375 L 5.15625 -1.5 C 5.15625 -1.238281 5.269531 -1.109375 5.5 -1.109375 C 5.582031 -1.109375 5.664062 -1.125 5.75 -1.15625 L 5.828125 -1.140625 L 5.921875 -0.140625 C 5.847656 -0.0859375 5.738281 -0.0390625 5.59375 0 C 5.445312 0.03125 5.289062 0.046875 5.125 0.046875 C 4.78125 0.046875 4.507812 -0.0195312 4.3125 -0.15625 C 4.125 -0.289062 3.988281 -0.5 3.90625 -0.78125 L 3.796875 -0.78125 C 3.515625 -0.1875 2.992188 0.109375 2.234375 0.109375 Z M 2.6875 -0.96875 C 3.019531 -0.96875 3.285156 -1.078125 3.484375 -1.296875 C 3.679688 -1.523438 3.78125 -1.835938 3.78125 -2.234375 L 3.78125 -2.8125 L 3.6875 -2.84375 C 3.601562 -2.769531 3.488281 -2.707031 3.34375 -2.65625 C 3.207031 -2.613281 3.007812 -2.570312 2.75 -2.53125 C 2.4375 -2.476562 2.207031 -2.382812 2.0625 -2.25 C 1.925781 -2.125 1.859375 -1.945312 1.859375 -1.71875 C 1.859375 -1.46875 1.929688 -1.28125 2.078125 -1.15625 C 2.222656 -1.03125 2.425781 -0.96875 2.6875 -0.96875 Z M 2.6875 -0.96875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(129.625308, 10.887099)"><g><path d="M 3.953125 -1.359375 L 4.328125 -0.296875 C 4.171875 -0.171875 3.972656 -0.0703125 3.734375 0 C 3.503906 0.0703125 3.238281 0.109375 2.9375 0.109375 C 2.320312 0.109375 1.851562 -0.0546875 1.53125 -0.390625 C 1.207031 -0.734375 1.046875 -1.226562 1.046875 -1.875 L 1.046875 -4.59375 L 0.171875 -4.59375 L 0.171875 -5.734375 L 1.046875 -5.734375 L 1.046875 -6.859375 L 2.484375 -7.09375 L 2.484375 -5.734375 L 4.109375 -5.734375 L 4.109375 -4.59375 L 2.484375 -4.59375 L 2.484375 -1.96875 C 2.484375 -1.6875 2.539062 -1.476562 2.65625 -1.34375 C 2.78125 -1.21875 2.953125 -1.15625 3.171875 -1.15625 C 3.429688 -1.15625 3.65625 -1.222656 3.84375 -1.359375 Z M 3.953125 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(134.076687, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(140.304462, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(142.813232, 10.887099)"><g><path d="M 3.359375 0.109375 C 2.835938 0.109375 2.367188 0.046875 1.953125 -0.078125 C 1.546875 -0.210938 1.207031 -0.382812 0.9375 -0.59375 C 0.664062 -0.8125 0.457031 -1.046875 0.3125 -1.296875 L 1.125 -2.296875 L 1.265625 -2.296875 C 1.492188 -1.960938 1.78125 -1.691406 2.125 -1.484375 C 2.476562 -1.285156 2.890625 -1.1875 3.359375 -1.1875 C 3.765625 -1.1875 4.066406 -1.269531 4.265625 -1.4375 C 4.472656 -1.613281 4.578125 -1.847656 4.578125 -2.140625 C 4.578125 -2.328125 4.546875 -2.476562 4.484375 -2.59375 C 4.421875 -2.71875 4.3125 -2.820312 4.15625 -2.90625 C 4 -3 3.789062 -3.078125 3.53125 -3.140625 L 2.5625 -3.359375 C 1.875 -3.515625 1.363281 -3.769531 1.03125 -4.125 C 0.695312 -4.488281 0.53125 -4.960938 0.53125 -5.546875 C 0.53125 -5.972656 0.632812 -6.347656 0.84375 -6.671875 C 1.0625 -7.003906 1.375 -7.257812 1.78125 -7.4375 C 2.195312 -7.613281 2.691406 -7.703125 3.265625 -7.703125 C 3.847656 -7.703125 4.347656 -7.625 4.765625 -7.46875 C 5.179688 -7.320312 5.535156 -7.085938 5.828125 -6.765625 L 5.09375 -5.75 L 4.953125 -5.75 C 4.742188 -5.96875 4.5 -6.132812 4.21875 -6.25 C 3.9375 -6.363281 3.617188 -6.421875 3.265625 -6.421875 C 2.859375 -6.421875 2.546875 -6.347656 2.328125 -6.203125 C 2.109375 -6.054688 2 -5.851562 2 -5.59375 C 2 -5.363281 2.070312 -5.175781 2.21875 -5.03125 C 2.375 -4.882812 2.640625 -4.773438 3.015625 -4.703125 L 4.015625 -4.484375 C 4.753906 -4.328125 5.285156 -4.0625 5.609375 -3.6875 C 5.941406 -3.320312 6.109375 -2.835938 6.109375 -2.234375 C 6.109375 -1.765625 6.003906 -1.351562 5.796875 -1 C 5.597656 -0.644531 5.289062 -0.367188 4.875 -0.171875 C 4.46875 0.015625 3.960938 0.109375 3.359375 0.109375 Z M 3.359375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(149.337073, 10.887099)"><g><path d="M 3.71875 -7.59375 C 4.945312 -7.59375 5.882812 -7.273438 6.53125 -6.640625 C 7.1875 -6.003906 7.515625 -5.054688 7.515625 -3.796875 C 7.515625 -2.546875 7.1875 -1.597656 6.53125 -0.953125 C 5.882812 -0.316406 4.945312 0 3.71875 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.625 -1.265625 C 4.414062 -1.265625 5.003906 -1.460938 5.390625 -1.859375 C 5.773438 -2.265625 5.96875 -2.910156 5.96875 -3.796875 C 5.96875 -4.691406 5.773438 -5.335938 5.390625 -5.734375 C 5.003906 -6.128906 4.414062 -6.328125 3.625 -6.328125 L 2.484375 -6.328125 L 2.484375 -1.265625 Z M 3.625 -1.265625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(157.455515, 10.887099)"><g><path d="M 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 L 2.484375 -4.5 L 2.65625 -4.5 L 5.1875 -7.59375 L 6.734375 -7.59375 L 6.734375 -7.46875 L 3.9375 -4.015625 L 7.015625 -0.125 L 7.015625 0 L 5.328125 0 L 2.65625 -3.28125 L 2.484375 -3.28125 L 2.484375 0 Z M 0.984375 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(164.4728, 10.887099)"><g><path d="M 2.6875 0.109375 C 2.289062 0.109375 1.925781 0.0625 1.59375 -0.03125 C 1.269531 -0.125 0.992188 -0.25 0.765625 -0.40625 C 0.535156 -0.570312 0.367188 -0.757812 0.265625 -0.96875 L 1.0625 -1.828125 L 1.171875 -1.828125 C 1.359375 -1.566406 1.582031 -1.375 1.84375 -1.25 C 2.101562 -1.125 2.382812 -1.0625 2.6875 -1.0625 C 2.96875 -1.0625 3.175781 -1.109375 3.3125 -1.203125 C 3.457031 -1.304688 3.53125 -1.453125 3.53125 -1.640625 C 3.53125 -1.785156 3.476562 -1.90625 3.375 -2 C 3.28125 -2.101562 3.117188 -2.179688 2.890625 -2.234375 L 2.125 -2.421875 C 1.5625 -2.554688 1.148438 -2.757812 0.890625 -3.03125 C 0.628906 -3.3125 0.5 -3.664062 0.5 -4.09375 C 0.5 -4.457031 0.585938 -4.769531 0.765625 -5.03125 C 0.953125 -5.289062 1.207031 -5.488281 1.53125 -5.625 C 1.863281 -5.769531 2.25 -5.84375 2.6875 -5.84375 C 3.207031 -5.84375 3.632812 -5.765625 3.96875 -5.609375 C 4.3125 -5.460938 4.578125 -5.265625 4.765625 -5.015625 L 4 -4.1875 L 3.890625 -4.1875 C 3.734375 -4.363281 3.554688 -4.492188 3.359375 -4.578125 C 3.160156 -4.660156 2.9375 -4.703125 2.6875 -4.703125 C 2.125 -4.703125 1.84375 -4.523438 1.84375 -4.171875 C 1.84375 -4.023438 1.894531 -3.90625 2 -3.8125 C 2.101562 -3.71875 2.289062 -3.640625 2.5625 -3.578125 L 3.265625 -3.421875 C 3.847656 -3.296875 4.269531 -3.097656 4.53125 -2.828125 C 4.800781 -2.554688 4.9375 -2.1875 4.9375 -1.71875 C 4.9375 -1.351562 4.847656 -1.03125 4.671875 -0.75 C 4.492188 -0.476562 4.234375 -0.265625 3.890625 -0.109375 C 3.546875 0.0351562 3.144531 0.109375 2.6875 0.109375 Z M 2.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(169.755241, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(172.264011, 10.887099)"><g><path d="M 3.109375 0.109375 C 2.554688 0.109375 2.070312 0.015625 1.65625 -0.171875 C 1.25 -0.359375 0.929688 -0.625 0.703125 -0.96875 C 0.484375 -1.320312 0.375 -1.726562 0.375 -2.1875 C 0.375 -2.6875 0.5 -3.101562 0.75 -3.4375 C 1 -3.769531 1.375 -4.039062 1.875 -4.25 L 1.890625 -4.359375 C 1.660156 -4.640625 1.492188 -4.894531 1.390625 -5.125 C 1.285156 -5.363281 1.234375 -5.628906 1.234375 -5.921875 C 1.234375 -6.265625 1.316406 -6.570312 1.484375 -6.84375 C 1.648438 -7.113281 1.890625 -7.320312 2.203125 -7.46875 C 2.523438 -7.625 2.90625 -7.703125 3.34375 -7.703125 C 3.757812 -7.703125 4.113281 -7.632812 4.40625 -7.5 C 4.707031 -7.363281 4.9375 -7.171875 5.09375 -6.921875 C 5.25 -6.671875 5.328125 -6.382812 5.328125 -6.0625 C 5.328125 -5.632812 5.195312 -5.257812 4.9375 -4.9375 C 4.675781 -4.625 4.273438 -4.363281 3.734375 -4.15625 L 3.71875 -4.046875 L 5.125 -2.1875 C 5.207031 -2.363281 5.265625 -2.566406 5.296875 -2.796875 C 5.328125 -3.035156 5.34375 -3.300781 5.34375 -3.59375 L 5.34375 -3.859375 L 6.5625 -3.859375 C 6.5625 -2.796875 6.351562 -1.9375 5.9375 -1.28125 C 6.019531 -1.207031 6.09375 -1.15625 6.15625 -1.125 C 6.21875 -1.101562 6.289062 -1.09375 6.375 -1.09375 C 6.445312 -1.09375 6.503906 -1.09375 6.546875 -1.09375 C 6.585938 -1.101562 6.640625 -1.117188 6.703125 -1.140625 L 6.78125 -1.109375 L 6.953125 -0.078125 C 6.890625 -0.0234375 6.796875 0.0078125 6.671875 0.03125 C 6.554688 0.0507812 6.421875 0.0625 6.265625 0.0625 C 6.015625 0.0625 5.789062 0.0195312 5.59375 -0.0625 C 5.40625 -0.144531 5.226562 -0.269531 5.0625 -0.4375 L 4.953125 -0.4375 C 4.515625 -0.0703125 3.898438 0.109375 3.109375 0.109375 Z M 3.109375 -4.875 C 3.421875 -5.03125 3.648438 -5.1875 3.796875 -5.34375 C 3.941406 -5.507812 4.015625 -5.71875 4.015625 -5.96875 C 4.015625 -6.1875 3.953125 -6.351562 3.828125 -6.46875 C 3.703125 -6.582031 3.535156 -6.640625 3.328125 -6.640625 C 3.117188 -6.640625 2.945312 -6.578125 2.8125 -6.453125 C 2.6875 -6.328125 2.625 -6.15625 2.625 -5.9375 C 2.625 -5.769531 2.65625 -5.613281 2.71875 -5.46875 C 2.789062 -5.320312 2.921875 -5.125 3.109375 -4.875 Z M 3.28125 -1.125 C 3.613281 -1.125 3.898438 -1.1875 4.140625 -1.3125 L 2.453125 -3.46875 C 2.253906 -3.332031 2.101562 -3.175781 2 -3 C 1.90625 -2.820312 1.859375 -2.613281 1.859375 -2.375 C 1.859375 -2.125 1.914062 -1.90625 2.03125 -1.71875 C 2.15625 -1.53125 2.320312 -1.382812 2.53125 -1.28125 C 2.75 -1.175781 3 -1.125 3.28125 -1.125 Z M 3.28125 -1.125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(179.359208, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(181.867978, 10.887099)"><g><path d="M 3.71875 -7.59375 C 4.945312 -7.59375 5.882812 -7.273438 6.53125 -6.640625 C 7.1875 -6.003906 7.515625 -5.054688 7.515625 -3.796875 C 7.515625 -2.546875 7.1875 -1.597656 6.53125 -0.953125 C 5.882812 -0.316406 4.945312 0 3.71875 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.625 -1.265625 C 4.414062 -1.265625 5.003906 -1.460938 5.390625 -1.859375 C 5.773438 -2.265625 5.96875 -2.910156 5.96875 -3.796875 C 5.96875 -4.691406 5.773438 -5.335938 5.390625 -5.734375 C 5.003906 -6.128906 4.414062 -6.328125 3.625 -6.328125 L 2.484375 -6.328125 L 2.484375 -1.265625 Z M 3.625 -1.265625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(189.98642, 10.887099)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(196.645309, 10.887099)"><g><path d="M 3.34375 0.109375 C 2.789062 0.109375 2.300781 -0.00390625 1.875 -0.234375 C 1.445312 -0.460938 1.113281 -0.800781 0.875 -1.25 C 0.632812 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.632812 -4.035156 0.875 -4.484375 C 1.113281 -4.929688 1.441406 -5.269531 1.859375 -5.5 C 2.285156 -5.726562 2.769531 -5.84375 3.3125 -5.84375 C 4.519531 -5.84375 5.296875 -5.40625 5.640625 -4.53125 L 4.65625 -3.8125 L 4.546875 -3.8125 C 4.421875 -4.082031 4.265625 -4.285156 4.078125 -4.421875 C 3.890625 -4.554688 3.632812 -4.625 3.3125 -4.625 C 2.894531 -4.625 2.570312 -4.476562 2.34375 -4.1875 C 2.113281 -3.894531 2 -3.453125 2 -2.859375 C 2 -2.273438 2.113281 -1.835938 2.34375 -1.546875 C 2.582031 -1.253906 2.914062 -1.109375 3.34375 -1.109375 C 3.65625 -1.109375 3.914062 -1.191406 4.125 -1.359375 C 4.34375 -1.523438 4.5 -1.769531 4.59375 -2.09375 L 4.703125 -2.09375 L 5.734375 -1.53125 C 5.585938 -1.050781 5.316406 -0.65625 4.921875 -0.34375 C 4.523438 -0.0390625 4 0.109375 3.34375 0.109375 Z M 3.34375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(202.551047, 10.887099)"><g><path d="M 2.6875 0.109375 C 2.289062 0.109375 1.925781 0.0625 1.59375 -0.03125 C 1.269531 -0.125 0.992188 -0.25 0.765625 -0.40625 C 0.535156 -0.570312 0.367188 -0.757812 0.265625 -0.96875 L 1.0625 -1.828125 L 1.171875 -1.828125 C 1.359375 -1.566406 1.582031 -1.375 1.84375 -1.25 C 2.101562 -1.125 2.382812 -1.0625 2.6875 -1.0625 C 2.96875 -1.0625 3.175781 -1.109375 3.3125 -1.203125 C 3.457031 -1.304688 3.53125 -1.453125 3.53125 -1.640625 C 3.53125 -1.785156 3.476562 -1.90625 3.375 -2 C 3.28125 -2.101562 3.117188 -2.179688 2.890625 -2.234375 L 2.125 -2.421875 C 1.5625 -2.554688 1.148438 -2.757812 0.890625 -3.03125 C 0.628906 -3.3125 0.5 -3.664062 0.5 -4.09375 C 0.5 -4.457031 0.585938 -4.769531 0.765625 -5.03125 C 0.953125 -5.289062 1.207031 -5.488281 1.53125 -5.625 C 1.863281 -5.769531 2.25 -5.84375 2.6875 -5.84375 C 3.207031 -5.84375 3.632812 -5.765625 3.96875 -5.609375 C 4.3125 -5.460938 4.578125 -5.265625 4.765625 -5.015625 L 4 -4.1875 L 3.890625 -4.1875 C 3.734375 -4.363281 3.554688 -4.492188 3.359375 -4.578125 C 3.160156 -4.660156 2.9375 -4.703125 2.6875 -4.703125 C 2.125 -4.703125 1.84375 -4.523438 1.84375 -4.171875 C 1.84375 -4.023438 1.894531 -3.90625 2 -3.8125 C 2.101562 -3.71875 2.289062 -3.640625 2.5625 -3.578125 L 3.265625 -3.421875 C 3.847656 -3.296875 4.269531 -3.097656 4.53125 -2.828125 C 4.800781 -2.554688 4.9375 -2.1875 4.9375 -1.71875 C 4.9375 -1.351562 4.847656 -1.03125 4.671875 -0.75 C 4.492188 -0.476562 4.234375 -0.265625 3.890625 -0.109375 C 3.546875 0.0351562 3.144531 0.109375 2.6875 0.109375 Z M 2.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(99.89729, 25.403228)"><g><path d="M 1 0 L 1 -4.59375 L 0.1875 -4.59375 L 0.1875 -5.734375 L 1 -5.734375 C 0.945312 -5.972656 0.921875 -6.203125 0.921875 -6.421875 C 0.921875 -6.785156 1 -7.09375 1.15625 -7.34375 C 1.320312 -7.601562 1.5625 -7.800781 1.875 -7.9375 C 2.1875 -8.070312 2.5625 -8.140625 3 -8.140625 C 3.625 -8.140625 4.09375 -8.03125 4.40625 -7.8125 L 4.078125 -6.75 L 3.96875 -6.734375 C 3.75 -6.890625 3.472656 -6.96875 3.140625 -6.96875 C 2.878906 -6.96875 2.679688 -6.898438 2.546875 -6.765625 C 2.421875 -6.640625 2.359375 -6.46875 2.359375 -6.25 C 2.359375 -6.15625 2.363281 -6.066406 2.375 -5.984375 C 2.382812 -5.910156 2.40625 -5.828125 2.4375 -5.734375 L 4.078125 -5.734375 L 4.078125 -4.59375 L 2.4375 -4.59375 L 2.4375 0 Z M 1 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(104.031826, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(108.524758, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(115.183647, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.96875 L 2.3125 -4.9375 C 2.5 -5.25 2.71875 -5.476562 2.96875 -5.625 C 3.21875 -5.769531 3.539062 -5.84375 3.9375 -5.84375 C 4.375 -5.84375 4.722656 -5.753906 4.984375 -5.578125 C 5.242188 -5.410156 5.4375 -5.160156 5.5625 -4.828125 L 5.671875 -4.828125 C 5.847656 -5.171875 6.070312 -5.425781 6.34375 -5.59375 C 6.625 -5.757812 6.972656 -5.84375 7.390625 -5.84375 C 8.578125 -5.84375 9.171875 -5.179688 9.171875 -3.859375 L 9.171875 0 L 7.734375 0 L 7.734375 -3.671875 C 7.734375 -4.003906 7.664062 -4.242188 7.53125 -4.390625 C 7.40625 -4.546875 7.195312 -4.625 6.90625 -4.625 C 6.113281 -4.625 5.71875 -4.097656 5.71875 -3.046875 L 5.71875 0 L 4.28125 0 L 4.28125 -3.671875 C 4.28125 -4.003906 4.210938 -4.242188 4.078125 -4.390625 C 3.941406 -4.546875 3.726562 -4.625 3.4375 -4.625 C 3.070312 -4.625 2.785156 -4.5 2.578125 -4.25 C 2.367188 -4 2.265625 -3.609375 2.265625 -3.078125 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(125.094068, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(127.602838, 25.403228)"><g><path d="M 1.265625 2.4375 C 1.023438 2.4375 0.800781 2.414062 0.59375 2.375 C 0.394531 2.332031 0.234375 2.28125 0.109375 2.21875 L 0.34375 1.0625 L 0.4375 1.03125 C 0.519531 1.070312 0.625 1.101562 0.75 1.125 C 0.882812 1.15625 1.019531 1.171875 1.15625 1.171875 C 1.382812 1.171875 1.578125 1.140625 1.734375 1.078125 C 1.890625 1.023438 2.019531 0.925781 2.125 0.78125 C 2.226562 0.644531 2.320312 0.453125 2.40625 0.203125 L 0.125 -5.734375 L 1.625 -5.734375 L 3.0625 -1.75 L 3.1875 -1.75 L 4.5625 -5.734375 L 6.03125 -5.734375 L 3.734375 0.359375 C 3.546875 0.847656 3.34375 1.242188 3.125 1.546875 C 2.90625 1.847656 2.644531 2.070312 2.34375 2.21875 C 2.039062 2.363281 1.679688 2.4375 1.265625 2.4375 Z M 1.265625 2.4375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(133.752701, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(140.41159, 25.403228)"><g><path d="M 2.625 0.109375 C 1.976562 0.109375 1.5 -0.0664062 1.1875 -0.421875 C 0.882812 -0.773438 0.734375 -1.28125 0.734375 -1.9375 L 0.734375 -5.734375 L 2.171875 -5.734375 L 2.171875 -2.109375 C 2.171875 -1.765625 2.242188 -1.507812 2.390625 -1.34375 C 2.546875 -1.1875 2.785156 -1.109375 3.109375 -1.109375 C 3.503906 -1.109375 3.8125 -1.238281 4.03125 -1.5 C 4.25 -1.757812 4.359375 -2.171875 4.359375 -2.734375 L 4.359375 -5.734375 L 5.796875 -5.734375 L 5.796875 0 L 4.421875 0 L 4.421875 -0.84375 L 4.3125 -0.875 C 4.125 -0.539062 3.894531 -0.289062 3.625 -0.125 C 3.363281 0.03125 3.03125 0.109375 2.625 0.109375 Z M 2.625 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(147.039314, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(151.532245, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(154.041016, 25.403228)"><g><path d="M 4.140625 0.109375 C 3.441406 0.109375 2.828125 -0.03125 2.296875 -0.3125 C 1.765625 -0.601562 1.347656 -1.039062 1.046875 -1.625 C 0.742188 -2.207031 0.59375 -2.929688 0.59375 -3.796875 C 0.59375 -4.671875 0.742188 -5.398438 1.046875 -5.984375 C 1.347656 -6.566406 1.765625 -7 2.296875 -7.28125 C 2.828125 -7.5625 3.441406 -7.703125 4.140625 -7.703125 C 4.835938 -7.703125 5.453125 -7.5625 5.984375 -7.28125 C 6.515625 -7 6.925781 -6.566406 7.21875 -5.984375 C 7.519531 -5.398438 7.671875 -4.671875 7.671875 -3.796875 C 7.671875 -2.929688 7.519531 -2.203125 7.21875 -1.609375 C 6.925781 -1.023438 6.515625 -0.59375 5.984375 -0.3125 C 5.453125 -0.03125 4.835938 0.109375 4.140625 0.109375 Z M 4.140625 -1.1875 C 4.785156 -1.1875 5.273438 -1.394531 5.609375 -1.8125 C 5.953125 -2.226562 6.125 -2.890625 6.125 -3.796875 C 6.125 -4.703125 5.953125 -5.363281 5.609375 -5.78125 C 5.273438 -6.195312 4.785156 -6.40625 4.140625 -6.40625 C 3.492188 -6.40625 3 -6.195312 2.65625 -5.78125 C 2.3125 -5.363281 2.140625 -4.703125 2.140625 -3.796875 C 2.140625 -2.890625 2.3125 -2.226562 2.65625 -1.8125 C 3 -1.394531 3.492188 -1.1875 4.140625 -1.1875 Z M 4.140625 -1.1875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(162.315282, 25.403228)"><g><path d="M 0.828125 2.328125 L 0.828125 -5.734375 L 2.265625 -5.734375 L 2.265625 -4.984375 L 2.375 -4.96875 C 2.539062 -5.25 2.765625 -5.460938 3.046875 -5.609375 C 3.335938 -5.765625 3.671875 -5.84375 4.046875 -5.84375 C 4.515625 -5.84375 4.921875 -5.734375 5.265625 -5.515625 C 5.609375 -5.296875 5.875 -4.960938 6.0625 -4.515625 C 6.257812 -4.066406 6.359375 -3.515625 6.359375 -2.859375 C 6.359375 -2.203125 6.253906 -1.648438 6.046875 -1.203125 C 5.847656 -0.765625 5.566406 -0.4375 5.203125 -0.21875 C 4.847656 0 4.429688 0.109375 3.953125 0.109375 C 3.597656 0.109375 3.289062 0.0507812 3.03125 -0.0625 C 2.769531 -0.1875 2.550781 -0.375 2.375 -0.625 L 2.265625 -0.609375 L 2.265625 2.328125 Z M 3.5625 -1.109375 C 3.988281 -1.109375 4.3125 -1.25 4.53125 -1.53125 C 4.757812 -1.8125 4.875 -2.253906 4.875 -2.859375 C 4.875 -3.460938 4.757812 -3.90625 4.53125 -4.1875 C 4.3125 -4.476562 3.988281 -4.625 3.5625 -4.625 C 3.15625 -4.625 2.832031 -4.476562 2.59375 -4.1875 C 2.363281 -3.894531 2.25 -3.453125 2.25 -2.859375 C 2.25 -2.273438 2.363281 -1.835938 2.59375 -1.546875 C 2.832031 -1.253906 3.15625 -1.109375 3.5625 -1.109375 Z M 3.5625 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(169.176742, 25.403228)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(175.404517, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(182.115348, 25.403228)"><g><path d="M 7.296875 0 L 5.703125 0 L 5.140625 -1.75 L 2.234375 -1.75 L 1.65625 0 L 0.109375 0 L 2.734375 -7.59375 L 4.671875 -7.59375 Z M 3.609375 -6.015625 L 2.640625 -3.015625 L 4.71875 -3.015625 L 3.734375 -6.015625 Z M 3.609375 -6.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(189.516998, 25.403228)"><g><path d="M 3.921875 -7.59375 C 4.460938 -7.59375 4.925781 -7.492188 5.3125 -7.296875 C 5.695312 -7.097656 5.988281 -6.816406 6.1875 -6.453125 C 6.382812 -6.097656 6.484375 -5.6875 6.484375 -5.21875 C 6.484375 -4.738281 6.382812 -4.316406 6.1875 -3.953125 C 5.988281 -3.597656 5.695312 -3.320312 5.3125 -3.125 C 4.925781 -2.925781 4.460938 -2.828125 3.921875 -2.828125 L 2.484375 -2.828125 L 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.71875 -4.015625 C 4.5625 -4.015625 4.984375 -4.414062 4.984375 -5.21875 C 4.984375 -6.007812 4.5625 -6.40625 3.71875 -6.40625 L 2.484375 -6.40625 L 2.484375 -4.015625 Z M 3.71875 -4.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(196.456371, 25.403228)"><g><path d="M 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 Z M 2.484375 0 "/></g></g></g><path fill="#77b255" d="M 26.832031 18.226562 C 24.703125 17.964844 23.769531 16.769531 21.898438 14.382812 C 24.289062 12.511719 25.484375 11.578125 27.609375 11.835938 C 29.742188 12.097656 31.738281 13.421875 32.542969 15.683594 C 31.21875 17.679688 28.960938 18.484375 26.832031 18.226562 Z M 22.144531 25.15625 C 20.140625 25.007812 19.210938 23.933594 17.351562 21.785156 C 19.5 19.925781 20.574219 18.996094 22.582031 19.140625 C 24.585938 19.285156 26.519531 20.433594 27.375 22.511719 C 26.226562 24.441406 24.152344 25.300781 22.144531 25.15625 Z M 17.253906 12.804688 C 18.304688 14.089844 18.191406 15.257812 17.960938 17.59375 C 15.625 17.363281 14.457031 17.246094 13.402344 15.964844 C 12.351562 14.679688 11.941406 12.871094 12.699219 11.175781 C 14.507812 10.765625 16.203125 11.523438 17.253906 12.804688 Z M 33.859375 8.523438 C 31.941406 9.324219 30.585938 8.769531 27.871094 7.660156 C 28.980469 4.945312 29.535156 3.585938 31.449219 2.78125 C 33.363281 1.980469 35.675781 2.132812 37.433594 3.644531 C 37.28125 5.957031 35.769531 7.71875 33.859375 8.523438 Z M 23.832031 5.726562 C 24.519531 7.984375 23.734375 9.457031 22.164062 12.402344 C 19.21875 10.832031 17.746094 10.046875 17.058594 7.792969 C 16.371094 5.535156 16.8125 2.933594 18.722656 1.117188 C 21.324219 1.558594 23.144531 3.46875 23.832031 5.726562 Z M 23.832031 5.726562 " fill-opacity="1" fill-rule="nonzero"/><path fill="#a6d388" d="M 17.058594 7.792969 C 17.738281 10.015625 19.183594 10.8125 22.042969 12.335938 L 22.042969 12.332031 C 21.988281 10.351562 19.894531 3.78125 18.6875 1.15625 C 16.808594 2.972656 16.375 5.550781 17.058594 7.792969 Z M 12.664062 11.273438 C 11.960938 12.9375 12.371094 14.703125 13.402344 15.964844 C 14.457031 17.246094 15.625 17.363281 17.960938 17.59375 C 17.175781 16.070312 14.097656 12.570312 12.664062 11.273438 Z M 12.664062 11.273438 " fill-opacity="1" fill-rule="nonzero"/><path fill="#5c913b" d="M 27.609375 11.835938 C 25.597656 11.59375 24.40625 12.425781 22.257812 14.101562 C 23.632812 14.183594 29.167969 14.6875 32.527344 15.703125 C 32.53125 15.695312 32.539062 15.691406 32.542969 15.683594 C 31.738281 13.421875 29.742188 12.097656 27.609375 11.835938 Z M 27.371094 22.503906 C 26.515625 20.429688 24.585938 19.285156 22.582031 19.140625 C 20.613281 19 19.539062 19.894531 17.472656 21.679688 C 19.648438 21.441406 23.6875 20.996094 27.371094 22.503906 Z M 27.371094 22.503906 " fill-opacity="1" fill-rule="nonzero"/><path fill="#a6d388" d="M 28.011719 7.71875 C 30.628906 8.785156 31.976562 9.308594 33.855469 8.523438 C 35.757812 7.722656 37.261719 5.976562 37.429688 3.679688 C 34.34375 4.277344 29.257812 6.941406 28.011719 7.71875 Z M 28.011719 7.71875 " fill-opacity="1" fill-rule="nonzero"/><g clip-path="url(#16c6c08de4)"><path fill="#a06253" d="M 14.121094 28.101562 C 13.660156 28.027344 13.046875 27.445312 13.117188 26.988281 C 13.546875 24.1875 15.367188 17.417969 27.503906 7.523438 C 27.867188 7.226562 28.273438 7.003906 28.578125 7.355469 C 28.886719 7.707031 28.539062 8.101562 28.1875 8.410156 C 17.738281 17.507812 15.988281 24.710938 15.589844 27.332031 C 15.515625 27.789062 14.578125 28.167969 14.121094 28.101562 Z M 14.121094 28.101562 " fill-opacity="1" fill-rule="nonzero"/></g><g fill="#000000" fill-opacity="1"><g transform="translate(39.401535, 19.959679)"><g><path d="M 8.453125 -11.046875 L 8.453125 -9.21875 L 3.625 -9.21875 L 3.625 -6.296875 L 8 -6.296875 L 8 -4.484375 L 3.625 -4.484375 L 3.625 0 L 1.4375 0 L 1.4375 -11.046875 Z M 8.453125 -11.046875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(48.335845, 19.959679)"><g><path d="M 8.234375 -3.703125 L 2.875 -3.703125 C 2.9375 -2.972656 3.144531 -2.441406 3.5 -2.109375 C 3.851562 -1.785156 4.332031 -1.625 4.9375 -1.625 C 5.414062 -1.625 5.804688 -1.710938 6.109375 -1.890625 C 6.410156 -2.066406 6.648438 -2.335938 6.828125 -2.703125 L 6.984375 -2.703125 L 8.375 -1.8125 C 8.101562 -1.226562 7.691406 -0.753906 7.140625 -0.390625 C 6.597656 -0.0234375 5.863281 0.15625 4.9375 0.15625 C 4.082031 0.15625 3.335938 -0.00390625 2.703125 -0.328125 C 2.078125 -0.660156 1.59375 -1.148438 1.25 -1.796875 C 0.914062 -2.441406 0.75 -3.234375 0.75 -4.171875 C 0.75 -5.117188 0.925781 -5.914062 1.28125 -6.5625 C 1.644531 -7.207031 2.128906 -7.691406 2.734375 -8.015625 C 3.347656 -8.335938 4.035156 -8.5 4.796875 -8.5 C 5.972656 -8.5 6.875 -8.1875 7.5 -7.5625 C 8.132812 -6.9375 8.453125 -6.019531 8.453125 -4.8125 C 8.453125 -4.375 8.4375 -4.03125 8.40625 -3.78125 Z M 6.4375 -5.046875 C 6.414062 -5.679688 6.269531 -6.144531 6 -6.4375 C 5.726562 -6.726562 5.328125 -6.875 4.796875 -6.875 C 3.734375 -6.875 3.109375 -6.265625 2.921875 -5.046875 Z M 6.4375 -5.046875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(57.398657, 19.959679)"><g><path d="M 1.203125 0 L 1.203125 -8.34375 L 3.234375 -8.34375 L 3.234375 -7.09375 L 3.390625 -7.0625 C 3.597656 -7.53125 3.863281 -7.875 4.1875 -8.09375 C 4.519531 -8.3125 4.921875 -8.421875 5.390625 -8.421875 C 5.859375 -8.421875 6.21875 -8.335938 6.46875 -8.171875 L 6.109375 -6.359375 L 5.953125 -6.328125 C 5.816406 -6.390625 5.6875 -6.429688 5.5625 -6.453125 C 5.4375 -6.484375 5.28125 -6.5 5.09375 -6.5 C 4.507812 -6.5 4.0625 -6.289062 3.75 -5.875 C 3.445312 -5.46875 3.296875 -4.8125 3.296875 -3.90625 L 3.296875 0 Z M 1.203125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(63.936885, 19.959679)"><g><path d="M 1.203125 0 L 1.203125 -8.34375 L 3.21875 -8.34375 L 3.21875 -7.109375 L 3.375 -7.078125 C 3.894531 -8.023438 4.734375 -8.5 5.890625 -8.5 C 6.859375 -8.5 7.566406 -8.234375 8.015625 -7.703125 C 8.460938 -7.179688 8.6875 -6.421875 8.6875 -5.421875 L 8.6875 0 L 6.59375 0 L 6.59375 -5.15625 C 6.59375 -5.71875 6.484375 -6.117188 6.265625 -6.359375 C 6.046875 -6.609375 5.691406 -6.734375 5.203125 -6.734375 C 4.597656 -6.734375 4.128906 -6.535156 3.796875 -6.140625 C 3.460938 -5.753906 3.296875 -5.144531 3.296875 -4.3125 L 3.296875 0 Z M 1.203125 0 "/></g></g></g></svg>
diff --git a/docs/en/docs/img/sponsors/fern.png b/docs/en/docs/img/sponsors/fern.png
new file mode 100644
index 000000000..4c6e54b0d
Binary files /dev/null and b/docs/en/docs/img/sponsors/fern.png differ
diff --git a/docs/en/docs/img/sponsors/fern.svg b/docs/en/docs/img/sponsors/fern.svg
new file mode 100644
index 000000000..ad3842fe0
--- /dev/null
+++ b/docs/en/docs/img/sponsors/fern.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="240" zoomAndPan="magnify" viewBox="0 0 180 74.999997" height="100" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><filter x="0%" y="0%" width="100%" height="100%" id="5cb88468f9"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 1 0" color-interpolation-filters="sRGB"/></filter><filter x="0%" y="0%" width="100%" height="100%" id="08b06b2c0b"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0.2126 0.7152 0.0722 0 0" color-interpolation-filters="sRGB"/></filter><g/><clipPath id="294e9b1262"><path d="M 36.867188 0 L 78.117188 0 L 78.117188 56 L 36.867188 56 Z M 36.867188 0 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" id="0ee6f724df" height="500" preserveAspectRatio="xMidYMid meet"/><mask id="124efb07be"><g filter="url(#5cb88468f9)"><g filter="url(#08b06b2c0b)" transform="matrix(0.125, 0, 0, 0.1245, 25.065686, -5.884486)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" id="72ff797e08" height="500" preserveAspectRatio="xMidYMid meet"/><clipPath id="eb5ffb5b46"><path d="M 80.65625 16.550781 L 148.90625 16.550781 L 148.90625 43.550781 L 80.65625 43.550781 Z M 80.65625 16.550781 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" id="48191ea608" height="500" preserveAspectRatio="xMidYMid meet"/><mask id="88dfb3f4a0"><g filter="url(#5cb88468f9)"><g filter="url(#08b06b2c0b)" transform="matrix(0.189516, 0, 0, 0.189, -6.315875, -21.98915)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAAAAAAC28+YAAAAAmJLR0QA/4ePzL8AACAASURBVHic7Z13gFxV9ce/57636Y0EAgRIQu9IVRFBioKAoICgoIIoTRBQpCgiIEUEBKRItfBTkaIICEiRKL333ksCISG9J/PuPd/fH292s7vzZnf6zmbP5w8lM2/euzvzvu+ce+655wCGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYfQ4UU8PoBIEECc9PQrDMLIRuBgwmRp9gl5oRR0HX3zE+msPzc0jIK6nh2MYRgcE+AtJznnzPydvEMNUahhNhcOgPzNJfCDJRY+fv884AGIer2E0BwJczSRQNQTvSebeuX4noFd67Iax7CGIL2FQqqoqVYNXMnn4p1sAMEtqGD2Owwn0gapUqpKq6hOSn9y8O4DIVGoYPYrDt5cwr1C2t6Wkv+/g5QCLHBlGDxJhu1n0VGUbeWMacko+9b0WE6lh9ByC1V5kkreh7TWqqlTvyfv2bjGNGkaP0f82Jh302d6UqiaeyS2bmiE1jJ7B4eRUoYUaTW0p1QfO+uWKtkxqGD2AwxcXMGQrlFSmk9KEfG4XM6SG0XAEK7+Q7eZ2MKQMCZecv3xTrr+IuDxidt5Y5nD4LRMWM6KpSNM5qSef26a5MhlEXMGunIyXDKOQ3nKXON39lhYCwq5GTAEhqvHc0y9LotCw0RVHhGD6n4MGDmhp6TcgSpbkkmTRwiXp+xCQPThAo9npJRIVrnzfBj5mt+OlEMIQ45+HT3fakLEVR1z6lOg3bpO11xo/eED/lpaW2IXEJ8nixbPfeffVlz4JABCxp0dqNC9xTw+gNISHbuCj7hUKAYQSKfde+Zine1KjAlEGrLTG6uuvv874IZnHcPobr7z+zptvB8C1GVvD6EDvsKLCjf67groundw2KBSoxjN/cFOPadRJALDB7tutMWa4AFACHb5sAkiDRks+eeux25+A2VKjVyO3M6cdMv+6ID0w4ZIjeugRJA4Yvt0pD80hyZD4kM/47wBJ1eC9klzw2FlfGglY/MjopTh8eXH+ri5Lo/rTHshicA7AWmc8MZekT+WZJil2iEXnXyJVQ5KQXPDUGevAtr0avZVb6Ltcb8nUqCfPaLgdjYAVvvqHySR9aN3Ymv10aXuzdd/r5Kt36m9ZF0YvxOHrDGUItE2kPvCChmpUBFj5Z88mZC5JbWT3o27d+JrkyAX37A0TqdHbEAx4vNMWtFI1qoEXRI3TaASsefLrZPBLC0OUNlJVZWpKb91rgOUYG70Lh68tZhkz0fYaDZ5nNcqOCjDq9PfInM+nOZUxYs3rNKfM3b2tGVKjl3ETk3Jmou1EyhB4QkMkKg6DD3yW9D5ftKXM4eY/E3zgwt+sYSI1eg+CLXNl2qS2216VQfXQBtzvDthqApnLB3DLf560hX01R753iGnU6DUI/khfwS2fapTquXCvuq9lRBh84qzUgpZvQDvKlAyevG49m5EavQPBeh8xVGJD8zc9E07+VJ1tkmCj+8gk3bRasUDbNKo+cNLBZkiNXoHDUQwV3/hKVSZ8YuV6zkcF+PokJqFqgbaOWKkJecko06jRG4j+xaT8eG6Hez7HO/vVb4ACnK+pCa1aoK0iJX3gk5v1khRqoy/jsMWiqm59pVIT/rhuFslh+E1UX90kNEOkIeHkveo0ZsOoGYKzmVQ7vWPQxXvWSaMOw+6h9xUs3HY9aqUmXLif+bp9nma/AzhsNzhUs5dSCIjv/+tVtB5eo9NV/r2zdxHTC9UKCiiRH7iOubp9niaXqMNma0JY3fqDUGK//uk1GlIHIh154zY+EkJqmsQkgBAO02p3SqOX0uQSBT4zVKsyooBQKBEP+RZr/se6MPofeYWWtt28dASAC9OsFkOfp8klqvgMVKq0T0IAAWeuXmtXVzS+YockEtbWhKZQgGRerc9q9DqaW6IOa2xVg5tfhBL51X9SgxF1xP127xALa25CAQAEZn5sVrTP09wSFWy2mi+xZFFXUCiOh+1WW1fX8bijVOqlUICYPbMuJzZ6E80tUcXn09q4VSIEXWg5fUQtXV2nO54COtZrs5sAM2aaFe3zNLdEOfAzcLWQgAgQha2+UUM1iY67eriP6rgblXh3cb3ObfQamluiGLdGjUaYeqM/qeHiKPHLNX0E1nI5tDMv2rKo0dQSFaw2tEYloIXCyK99Ui3OBQCIcMRBIarnRJTAC3U5tdGraHKJrjWoVjZKCDp8Y9MaRYwkbHo6iHRtpB4IGE16tT7nNnoTTS1RYC2gVpM9gYgffUBNzgUQP13RR9XmPXVxforimakWLTKaWqLEWLDK3KKlCMXhexvWZDbqsP83NJL6TUQFFDyoVvnaaGaJCoeMT9v71QQKnR91XC1OJTrmNKiwbm4uKIwWvmZG1GhqiQKjVqjhyYRghN03qomsDls3RKhfeSGCwKRXTaJGU0vUYdzytcxPFwjCintU/zcLxx8OqaObC4EQr0w0iRpNLVFghcGhBrlFbQgF+PboUL3oT1vJS/2iufnp991N/usYDaG5b4KxqGl6HUGXbLBPtWd03OEbcPWL5gKAMJpyJ6zhqNHUEiVWQk11IAJx2HdQlXe+4pCBvp5uLgAE/GuypRYZzS7RwajZkkv+jHTc6tPVmVGHbb+OSOrr5jLy/7bsPwPNLtHRNb5LBQId8sXq/mqNz+jn6+rmCqHyypMWLDLQ3BJFy9Ban1EowC5DqgkYOezxBUa1te6doAC492NnEjWaXKKuf619PQJOt/xyNX+2xt8SBevshUaz/2xG1ACaXKK19yVFKAG7IVR8Boet96TULOUpAxIIuO7l+oajjN5CU0u0DjogEGHrVSs/gUY/awk1qNVSHBEwnnudBYsMAE0uUal9FrmAwvEbV3z/C3b4kkb1tG8EEfDQU7YoagBoconWYzYmEA7YugoTtW9M1DtYFC25xDf3L2M0jKa+EVj5lLH4OQHiC5VKzHHdPdOtp7Ud1VIoQJAb7nVmRA0ATS7ReiCAYKNPVVh8gfjeSkl1PWa6uYBQNJ5xmYVzjTxNLVHWw5IIxY/cobI/XLjedxHXM21BKAy48WkL5xp5mlqiYUkdjAkhxFaVLbsI9hwdpEYVz7Ighdry9rkWzjVaaWqJ+jl1OKkIHNYeXsmyieiQr6bNEGs/LAD5noXQMyZGNhM18jSzRAV1aQxGCMaOreSTDrt8TmtXqaUQISSJ/n1DFakVxrJGc0t0IeqSviActkolHwz9DofWMXOWhISWT05JmvlXMRpMM98MgikQ1kMROrASKyr4wg4a1S87lwIhcfILsbm5RhvNLFFgIqT2CxwCAdatSGh71zNtgUKhj/92rfj6XMDolTS3RGcsqI/RkrTkSpkf4iq7QOpX9k8oCC2vnWjzUKM9zSxR4oPpqNMKRwUSdfjm6qGOaUUAQjzrkI/qmgFs9DqaW6IzZtRrgWPMsHI/IWH576BuXZbStCLBaY86s6JGe5paojLv3frM/ARDVy1f+1/8VIjqVVSMQqG6cy8VCxUZHWhmiULwfl3iRQT6r1SuRIk9861W6gCFwhDffFo9Tm70appaosB7QO1dXQKMy3V0BRt8sTYdw7NGlAZz7zlsidUrMjrR1BIl3l5Ul1UXIB5RntikBd9doU6LIUwV2vL092baFjSjM00u0Ulz65NuRwwq53AR5jb6JqQ+wSIBhb7lqQMmm0KNAppaosDESfVZcyEGlHF0RG568b9X0/oEiwiAvuXFA94yhRqFxD09gK5Z8OyWwdUlRFNGWSQXxpy4/2hoPRotUQgKQ8vjB71tCjUyaG4r6vAgpB75RYKk9DHojncfO9qHujRaEoqIhviBfd40hRpZNLdEgeemxfVZilxY4nFOcfqdGycaRaz9QAgKERD/eS+bhxq9EcGACUyorC2qqt8szdWNMPwKMiGpNR8GlarUHHmJa/pnpdFTNPedQbf4cdS8EAkBSWaXdFIX1v/XEUFjkIAQqbRqNB4KIQwtsw4+Rs2GGkVo8nAR8NSS/rWejAqB3PQSdCbQbf8yLomFEEpeUhDWJFM3LYISEL99xASnplCjtzL2g5q7mKrKKSt2f2kHHDmTSeqOpo4p1XtNz1DlmNKzJuRfV2lyV8YwuuYm+lpLlIEvdH9hBzmHTNpmoapKVZI+qFap0lSgwXPWsc0+2TCMLnH4Or1qTTWqDPxXt85zhDE3MnhtUyiVGnjNVQtITUIadKpIpZp+NCTkrVvUr5ygYTQCwYpv0rOmGlV6Xtqd7RKs+zh9YHuFMse7I6x74ZsJmQStzONNDTDVk1NOsEiu0esRXEpfW4Wqeh7dtfESwZffYS60m4aqcgnfXR8OWOWA6+bkp6VLJ6plKVR9YO6KjczJNXo/DnsvSR3DGkpUF3+lS4kKcOBcJm2urDK1oVM/D5fWLtrkvNeWkIlPTWmpOk29ZtWQUB/ZyQRqLAsIRr7EUEtPVzXwk027kmgEnN+ar9D6GWqOk7dPRSUOwAp7XfkeyeCDlijS1jmo9+QD3xqWnsYwejsOp9Q6wcjz6ZFdSNRh5PVUv3SiqUpqwhc2W2r2RACMO3zCTJK5JA32dq3SvJA1pwwvHj7QTKixrCBYdXItzagqc7y+C4VGWP8Rem27olJVg+e9q3dUlROg35Y/+ucnzNtSarZMU/mqkiEEMrn9OyuUtdPGMJobwQVMqs8VaKfRhD8pmlYlgm3fY047Bop84D8GFcjKOQDY6IT7ppEMubYgb/uxautEWkOSIzn1pt2QytswlhEctp7JUCuFqjJwxqeKuZkCfHsac60RorxQPXnZoMyPiBOg3yZH3PAuSQYfghaQWuFActa/j9kA5uIayxqCW5jUzNNVet5fzM91wM/bZxSlEdiE/EVxYaW2dMV9L3/s4xxJhiRJvA95vE+SREly5mPnbwmYi2ssewg2nZOf59VAoaqeZxTRm8Pgqxh8u5y/VKFzvtd1EpCIABi2yd6n/OPlORkXDdMfvfTgTw9tPdAwSqdX3DHCS3/o49oUJSGAJV+7J3N3ttPR1+wZRKRtKwsh9C3zvnNbt7u5xVEBwG302fFrjxoxZNCgOALDvMULZsx465ln3geAiLahxSiXXiLRjf67QqhJByZC1L2284dZ7zn9zJWb+ii/9axtP2f8zqH/K2k7p6QXAOCGDxo8ol8/8cnMBYtmauubViPXWFZxOCe/Kax6R5c5Xpt5EcG2H3bcepYuh768SVnxHYniToe7yAK4xjLPwIfoa7BxVJXquW9GyEaA76SbQ9u0nG4Xu3dcBQEecW2YOo2+gMNuixlqoVF6Pjuk0GMW4BjP1rz4NoUmvHW4rZEYRvcILk9NXHUaVarnWYVmMYL7LXXp5tC2hIWrB9oiiWGUgGDgI/SsVqGqqnO3KzCiDkOuYwhtCQsklfSB54vZUMMoCYdtZzJNba/Kino+MKTzuSOMn0C/dHMo8ylF4bheEvI2jCYgwg/oq5uOKpU5/qizYXT49NvtQ7mpl5tw3oGwTAPDKIOLq52OKj3fWa2TRB12/ZC5dulLSiUTzvyqmVDDKAPBsP8wV41GlZrwnI7xHwH2n5/f2bLU1mqOU79kgSLDKAuHMY9Uo1FVKuds28GICvCjhfkl1w42dNL2FigyjDJxWPfNanxdZeB/+3c8I85h8GxXAiW1tW9sZDbUMMrGYbNX83a0fJGqqib8dvsJpsOgK9KdLe3qzZMJn9/QbKhhVECELSamGq3IiCZ8rH1mkcPgm9rXys3XF/J8bEVTqGFUhMNWz3VYIClDoKqBR7bzXyOseTeTjgol1fM/Y0yhhlEhDms+zSRUpNHAd8YuNaIO6z3PRDvZ0BD4j8hWWwyjYiKMuY2hfI2qMuG57RW6fUbCQvC8bojZUMOoAof+19N7lhc0UmXg5FXaJOqw/ScdVnCUSobA31vSn2FUh4M7aXH7OpolebmqydKaRSLYb2aH9Zu0Tl/glQPMhhpGlQiw59QOodhSNBo4ubV+ggi+uyTdHbpUwqQP/K3ZUMOoAYKN72K+ZHxJIlVlwqvz8hPgZGV7hafbQ5XnWqTIMGpChP7n5UpffVFl4Oz1Uv054Iy0Z0tnhZ5lNtQwaoQD9n6V3mspbXiVqp4Xtyq0/1XU9l1i8grV08QUahi1QgRj/kbmlCVYUmXg1M0hACIMvK7D/u02G3qi2VDDqCUO7nvv0XvtNmyk1ByvzSt05C0dJ7GpQhlOMoUafR2RTiVlXVRViVkHrHEjmYRupqSqGjh9QwgQYaUJ+eSkDl4ueZyVWDD6OG0CaBk0ZMRyQwf1a8siqFymEXDgS+wmbKRUJvwNHOCwxuMdj84rNLEyRUZz0tDbcuDokaPXXn2VccOiGCEsnDL1o1cmTpsyHwAcK+um4BSjzz6wXxBp6/PQGQpF3ce7viB0us4tGySxoO1ACiEhwtGXddu1xTCWaQSf/8N9b83ubOFyEx/68+l7rwFU3BbXAbv+j+mOlWxLqtQcr4TAYbPXmWvfozdvQ3M/NC/XMK4jSZ8kS1tvtnbeTKbd/d3VUKlIRRAd/QnTTStZfexVAyevDefw2Y+ZsNDL5VE1/lMNo9fhsP505nzolPiuGrwPSvKjv31vJVTYwNoBG165gCFzkVSp9DwNkcMXP2aSYUOXHLPs2lBpiWtEixWKWbYRnNZaCDOjzbz6hAwfnjUWFc6OHfDZR9LYbqcFGKUycOLaiPDlefTt3073tpBH1vhvbSKW1SdPX6Jhv+GIZ9ZQV9ghlGmURqDqHD65488PQCrpw+nIQQcdtikK40YU+pbzTor9V/8wysdo6+7bGilKfnphRVfsDQhX2sPX5idmv8n/DjU5k9GUOOwR2kpJZ4RzVKkaEnL+X9dEZbX3HLDcKbMLpqRKTfjmGOAbCwtsqDIoj12GbU2EnTK/8Yp4fdCy+0UZEFzEzvPQQpUyJOSUc8ZW7u1udOlMBh/YNidVVfU8Fjh4Xsfynvl5qP6087UkT/Y/excRtuXiJblasIiPDDSJLrsIhj5A32XLpLwpDQn57iEVGlJxwOY3K0PekrbORF8bg2NDhg31ypM6Rorc0g7bLorjuF2MOYp631bvCNvRZwUAyifh42ZFe4S4IVcRrrExJDuzoPUQCIVwjmH1a3b61UuoIJWAFDy7z1eP3Nl5J0JChEJ1V0/+0XkuRB3noQJ1csa5aJuHCkBVDF5p7CrLrTx41KD+LfDJklnzZk1d+OHUqbND/pCyR9XjmLCMbolwMHPdFxrKFyNKAj/6ToXrL3BAvwNeJRPPdE6a8KH4JAbfaYJKDZ6/bLt/JQKAAZscfOVDHy4OncYVFk956qbT9t1oYHpk77nlUyva3ddeEmZFl3X+yqSUYmB5dzchL1+h0hpCAoz+8UtkomnZ+tyeR1F9x8WYtBrnua61DIMDMH6/Cx+ZQZIavF+aX+F9COkHpz1x9ZFbD0fFeVCNxyRqlMrI9xhKrGBCTVvYP7VxxXdEBCx/2tQ0KTDwzl8X2lBl8Lwob0OdAEN2vmpSIOlzSeg0Z1ZVDT6XCyQ5/9nzdh6JvKibHpOoURqCLReXXK0v9XZDwg/2rDjpRxyw8SXTySSof2w+O9tQUj3/1B+CVKDrHf+QJ0NIE50y0iuYJkKFoGR4+qKvLo9KHfGGYhI1SkPwDXa2TV2LlNSE4ajKQx3igA3/tphUr9qxVKCmZVL+7CCACLDB76aRmmuVJwsWcNu9qD6nZPLuqeuiFzi8JlGjNBxOLtXPbdWoUhMm1RRCEAF2vX46CxSaZjP8czAcRIBtfjed9Pm11K53naYyVR+UnPJ/ew1sepGaRI3SEPyuy8SFTD2QQXleNUsG4iA3s1PdFKVSPf/VAoED1vzjAqbB5q7k2fbhvEg1JGTy2Ff6Nbm7axI1SsTdRF9mB5Z80PWsKoryCeLzfSfTqFQyx0eWR+SA8Wd+zFKrCLYbmCrVJ0pOOHBwU4vUJGqUyID/0ZfbtFeV6gPPqPiiAlxG7ehg5xX6zGhEAjlkYro0U2YLpzSgpeo99Zk9mjk1wCRqlIRg2BPlSzS/eOl/XPFV8av8akt7cZE5vrkBWoAv/Jtpsc7KepXmHyF6/dbNa0hNokZJCMa9w1DBnZKm0X6/ooRdAX7DEMjOCk344afQgoEXLMy7uOXqs+1cSmoSOO/cgc0aNjKJGiXhsP7kMsNFeRkoNeGMnSqwUgL8ksEXRIroOf2LAHZ7mB3a/1ZAXqSefGLvJjWkJlGjJBw2/LgyK5quj3ywVtkCEODs1h6k7c9Gz3l7ACN+t6gqE7r0jEoGz+SPFacr1hWTqFESDhtVJtFUozne1b/Mm0OAnzFjPZSei/YHdnm6NYO3KoW2bXP1yqd2bMawUTGJKtWXyRI+avtFl1kql2irHT2zbIn+vFNebn6lNfAY9DtrEXOBWo2T22GEypDjwhOa0NktakUr+cNfMivaIzRmv2gggK52ixZDKJSIP3/6NqdlfIzHnkFGaF/DSChQRqdcsvnpeyDEYLvdo9UgFEJiP/C8jU6ZFPWS6j4heuFylrchl/0m53rjZlmjFBzW/ahCK9paY/Pp5cp4gjsc19mGkumk8Xx8dxqTUKEdKTpCpXrP59avrFhE/ShmRRPe0tNDM5oJwWpvVxTRTRWg1ISnli5RwcGLC/e2KIPn78ZcmW8AUxMnd+nJ07z/t7/YZL5ucYn+KxInZdGk60pGLRAMebSS1IWlEghMti5VoxEOWtJZoaRSA6/f+YXUvNZSoPmzKzXhrL2ba7rWhUSbapxGFzTiqU8ki6r6OJ2Pj3alTYRc2OPifh3qFAEAhXT3vfCXTRJEhNQ6+ioQocR+xA1HFpYKNoxqaIxj5mdWs6sMgMOeny9pohfpbn8ZXqBQAHSTB54xOsSCygJX3UEh49DyuxMtptKe+pc3rVkN1WatxNqQiK6EqZUU9Gv7OOn84GMfLCFcGoXt/zTcRxl9DIXLjUGIwHroE2lkl1Fw58q51fytywYiTtMIfFt5RQeWE5MvYjs6trgUp2x3Be30tWeeorBJpjgo2w01QucT9SyNkSg/AKRicVCIKOy9yz3d3voufO6mFUIMZm1hG6iIUKwJafXkNSq/XnhpXc7fe4gQqEDUEre4ljjng09yDABiLV2l3R8pLgTEA4eOGsQFM+YvCgFx6HCDlHQx53wApH9LS9wvl2huiQYgQhOtnjVmXRSTIJVP0iSV1b73dHdgFDa7YQWf4eUCACiS9nGpcBjdkWpUccm8a8taxF2mcFAEjFhjjTXXGrv88iMHRkAyb/rMDz94580P3vaASGm9ngetkHWYmz279T8FDCt/buvN11tJAOhHbzz38CMzOvQDGjYy41cQP6Wd+kRUddiGG2y01qqjR/UHFs7/ZOKkV156+0NApFl+w4a438LPPtBSzcUI0L2z0wddm1Gna92zho8kS6HMy7NOJrT1IoSEaMFX7m+SHIYobPdAyFgt8fHtX62HM+ckAKt/acf1xo0ofHPiu09MeGgxEPtuzyPc/crFhX5qGH7eBflbIArY5MgvrQEAaH3qvnb/1c+3HRuFw0+bX/Cna//Je09uu4uiALfT1z+zzsBOB7373O13zKq4cXwvZfkPqkq3U6UGHth1wCjC2GeZy87ray08VNu1lszL0HPK5k2yPtrYRRdxwKrf+c8CkkxyiQ8hX0AxBJ/klKS+c+E2UQkxSsE3s7/gX7cWPsZqVy4ifa61HUbwOU8uvGbV1lPEODnzDDPHtVU3Fwz9/rMkmUt821B9kiPJj89euwkTOuvKP5lUuakkx793aYYdRj/GXAN02PUwVZnwyZHN8fM2UqLigA0umERSEx+0Y2HztJSMJ8n/fK9/ty17BPsyyUrlPzMf38c3P8pXtGn3zftEuXvrFx/jBOYKzpDwo7H5uygC9n+eZJKEjkXQNS16M+vcUc26DbgeOByVqqfiW18ZOGOjLm58h2F3d+x91iPk8/6vbQqFNlKiDljz6nlkWik8a3eNUlV9IF8+rKWbCsmC/bIyRhOeDQEccH7bVqX25/d8bmjrYzzGiRl/euDHeYlGGHtLOtqCwSpVNSHf3q8pDGljhiB4cl5LNYEaEYof+eniBziNLt8lieo71yyBNO/fH3RSM/y4jUOcDjzlqUOH+BA7SGZJuPTVSLxueNUDu5EVfz+i7trjNcToeBkBFffMi0rNcNnl0a+pjx0KBysQIFa/5o0Xt2jPZ1035kZSvPs6ytxa0RFCBJsWjaOLxld8K8RYGjsAQJANn/ILheLws22b4MdtGI667QNnLhcYRV0urYkQsWjY+s6rRlb8/RCXHxRQKEVhy+I7SjyH6OF3ruIlLjZaEboo8Jh7lg89/qhtzAAoM56rru+fAIINBxe9AM46NDgRtneghCLS8DQCISB+6KUrhT4zkYkUJ/9vK68R0F2PDxFAIs/DHv18qCybJ8JPDg/OseDTJF58WEoKpTsee2UU4q5GK0AEv8PdK/f4o7ZBzwjBQ3DViZSCsSOLvOdw8kkUYQdDTaRWlI1OyRNKnHzqlD6TrOvCyFvPjkKUIZssBIzh151wREW5LFHY+pzsVrUiuKm07zzSQ38L7c4lFkrkt7h3pZ62ow26vOKB2VUUrc4zZtXsUzj9/plQ12ELd5q/QIXUJSW3C4RCRDxklx5//jaGSNea8NXAqOTvWUDEod8VZ1Tyy/iW81u8y/gg6Rb/s6SncRS+bLt6bAAAIABJREFUeCXUdRsbEUrsN/pbi/bss7ZRTwiZdAtCVWZUoIPWzRyv069d4kLEjikLaR/uCCoZeZl1RQhK6P+rUX3C1Y3CJhM2TZyUZkIBACJgFPQXv61Eowdu4+Os31MC7n6vpBvMj7nGhVJMvpBRssNlZQ+xtjRMorjKx6wiwVwIYlzWO063/cOg0Cl1niTgo6d/DafS6Lx2EUjkNz+2oRftIVzY5M6xvqXMULqAEfTYc8p/Zg84Hi4rT40Ebisln1WAc8b70gK/Aon1sAMqjz7XgkZdnHjlQWgVUV0CxPiMN5xu9ueRnRUKAUTj6cf/7ApobYoUlUMa1f3+Bj29BFR/Il399lWTopHRoojQQX9a7tpUjP3X08yfUzT+YEIpmfMOex6oUYk2XyjAeav1qKvbMIm6+XcDVWzVFAGwYuFv4HTsX8YnneehBESd/+EDOOm+2BMNXnwRgi6M+UUjr9kjSBh+01hf0ZK30AG/3qu8CXvA16GZFyPw0KSohP0xHiehdMkJnV+ljKo8daBhJpz4+9SIUvlslBCMHlqwDVRHXLGhj4UdnB8RComzb5Ro/lHvtKigwb6uCCD4+h496yLVHSGu3jKJK0tKEbqAq9cpK2A6e83ts7PyCIcbSrm5ZMFunwtx6ZZC6PCtLbUHf8fGSdS9f3WRB2BpCIAhwzq/SHfFbj7qFKsgKAzRH04HQ/TmUfMjbXhYl0Ln4yP6N8uOpvrgcPx+Ic7ewkRQfZIkSeIDsyN2jPzyl7syTBpW/sYgX6RCjrz935J2iA45ssyopfMDjy1t72lvR7DiewxV5NBq4AdrFzxTfkWv1IL+Z5rjY6PyOdcnMARWkyFc0WhVVXO79OziaJc5utWPzOHTucz266rU4MPSF3wIGT+8qnpmTUeL5Ogqcx073bV7J+FZHf6i7BxdZZjVMWm+22Jzqsol6/bg79igLd0AKFNv+GmV8+6BnXb2OT3xZypSUEoM0Jb3vz3DKQCV81f/ge98UN0RUELLz+9t0j2HEmmJ9doAFKlpItpyQYvPcBop9LEA7741efaSaPDosRsPBLwrWIkUiuDnt71e6iRE2FIs4MhI74TrNrVI6Ea07vhvTW0BRcQV3esvhPY76OTuz70M4LDOx+U26+7wOAuc8+kO25gcvraYvpMNTatac8EerYcKlnuEuaqaoFU2Xqpyrx5Npy9uRW+uydmPy6q9qkr15PO/2HKFfumBw1bf/9a5ZMdOkvlDPW8o1EZRK9pm8ZTp5s4kSbxX1YQPtpRkRVXzZ1ENydI3vNeifpZ6vtyDzTIaZ0Wh7s3zL2BVpUmiDsONwjbX9PcxO84zCUCJ029v3d1PN+uQu8f6uEYdIkqFQvHxt27vvsZA43HY6MzSvwvtP+nKDBsiYdUTUZgDTUGIood/e4sirapHnTv3ves3PPqQyHfeiSSg4zeuvbvEIhXSWl6VEIaoXfwhEHcnpZRzgKSXFWokbtErk6bN94OGr7TW6kCQYglHgnW2ntAnzCgw+InU6HVlfIqiqou2a2dFHdZ9m0lGTWtqjle2j2FE2G2hFj7D60y6x3WDnjSjRdsuhYzXumDigIx71+GijH36qvRceFwMuDYJiYgDtn+VvuC3V01YuD2liBVt+4zSk5z/5O9PPfoHJ55zyyQl56zXcYjZVrRtjOrJhw/faLn04JbVdrpiJllsoqs5ntJsvUDqhMPXg2aFF0pCVRdvv/Sbclj+UeYKW4QqmePjozr8YA4nMOmBkBETntGTAaPizQtDrnQW8ZmM7pEO68wu1JEqE76/daF75hxG3pWhUapyx86PsS4lqsrgyXuPaCuC0n+nSz/5T6cRdiFRVQby8d3S41paWhwAjL08FNMoE97dryY/SG/gT0wqVYoGLty2TaKC/n/PmGGqqnpO2qzAdv2+WFmj+qHKwI9GN/orbkdtWgB7vpAh0QjnMyn4JZWeb6yFKOO5FKPfrYUiUHr+tfOhXUk0NaH3fyk90OVt9ZrrF1ytuETpyTNiwLUusYpzAuw5pYhGNXDyin1k45JgpVcrXnjRwHlbt/M3LsoQnaYNYL7WWaEOw/5X6BTXGVXVwEN70NOto0QdVvuIvuBPpueH6xSJcETo/3Cha6zKeeM7HdmFRFXpueQ4dKh/5AovWFyiysDFBxTUT5IIG00sEs7UwM17TKKNvX3oppxNqFSaquuT1lXnCCf/SGN0yiikUKg479bOhWzVzT38zdg3NmAkECi2WlY7SOw6JiMZnZE/6M2W7LhNiJccPC3uvH4j0CHfLGOmJz6a9pULO1ajVu/KuJHV4aC/RZ03fzO0vLzv/OwUQgE2K/38vRzBJZUWAdPAqRvnnykR9spleCVpf7K/Zf1cEb4wO2OBpo5ouvjz+R70kOrp6OLRwoaUSs9Tu5BbhMMzPpTwv52OK25FlZ5TtihB0UWtqNLzlGzTFOEHmZkY1MBf9RFHFxAMvb9CjWrgxHXS79Zh80lMOoeK8hUyXx2bvasUP2CoOFZVCUr1PKoZw0XlkSVRwea5wickPZ/LCv4uJX6yMJocOKtT7KCoRJWBC7cvZamwmESVnv8rPsL7Ml1dDby2jzi6AN28oz6MQ0UeJ7FkMQjA6erXr+ojSsfsUCFE4wWHT8zs16ByxSlOKY2qk0KCPrr5ioZcrOFE2LMlFOiWgt8sztxw3foxf0nBriNKMmKrUgVA4MT7oyrWmoWR/pJFrHCEC1Ek6Wq1yi9ZJQ0PZWj0ymELYq2spNCSxQAgOvDSdXzcOTWeBBT4yUNFO6qcd306HW2ARglAQstbJ5STZ9eL8LJD4c4Eqnv+7112LCImvB11ygIVEXy2tD5HFHX/uayqnkgM+Pf9xc6guO9JyaiVIcDKVVyzOhofbQzurhPhmFkhqjtyiwGAuGj3JAI7ZrZQIAjuT1cV65dDSY6a0BIao9HUos894r1lswOTw4brZ9gbwS25LusZaPTxIwW7XuiwTdHajgWHnlrlPRvhH0Wnsoxz9xXZttivx6J+PbAgoLj8TIEW2aDUJfMWgohwzOEaCcFObq5AW54+ofin6WYd/FIcUF1F31IgCFHg5/9dNhUKwfor+KyEo9u63bb1WIFARLDOyiV5uhLk9ser3BgmM+8qboYV94ds/Was6zSInlizE5x6tgNFyty4R8z0DlH42rmgY6caqKQwRFOPmNHFU1yjSd/4IPZSd40KRaju/MuW1X2Giq0zitASb77RzU+qeHFxRuEhbFLKVUnBDVVm4hHPf1L8XcVzC7LfiQdUddkq6AmJUnDKbxxCea0ECcFciAsbXDrAu86VypimR5/5TJfZziF67cAZddcoQYAhvunny2ygntEmGQ4h8fzibj/6fsYhxCalfFWi0aQnqnM4STzd5aWmf5B9AemxHN0eyXyh4IRTXeQpnaN7XSAAZsLpiD+u6iPp1IqDQmFwl/6um8atIXrw0CVxqK9GhRD6+J7DkmUzVAQAgzbOKFBCvN3d54iPFxdqgFinFImSePudqlvzvt71pT6s8vQ1p2c8bArPXPTLQUmc/qO0z0AwDeou+UzWvjICIX7u9G7PEtwtR14VFxTdrSUUgKHloe/MWUYnooBwXFbqMTEbg7v5m8lMT3J8ScZR8CqqWXEBhJjU9REzmi0brIcmwRT+5qUrx3vn0m3vJX5sFsKJ3/FRgUIpFI1nHTWze1Go++OQi6P6aZQiFIb4wf2nNUmr7rqwdtaNHOOs07vxToRSmKkkwMjBC0rwawTvVDm7p2BW10d076o3mJ6KUxHRPbtethOSWEoTCwHhHOx7JlxBjROmBf9OeawUURCXDDynsHh9zSCEIX7kG1OWYYUKx2Y9V4X9StmzVbieKhg8+r1SrosuQj2l4dCNFW66Lfg9FkpGiF7/2g9PHqrq0vWT7vQilPDemhf3KyizkHZR8S03XFFSWywKz+W59bGjFAKiGk84sKkVSmEZo9OMPyWzL0CJE/yCr12IAcNKKaMqKBJvLYPQ22YfPSdRBDf/1w+csnOs6gTd64XAzOjylX1hTUgC0JbXT2Jp0RkKzstdUBeNCgVQxrceNLeZFQqhlPXDF9RGxehMK1piBDvjqAHDSvoscyVdoMyLNzc9KFEo3GN77/7TrUAf5Zf7u5CMEEvO2CFkT0QZLTh6YqmqoOC32jofreFPlub/hhgXnrKouSvdhOjRU8uIaUdzcp2nnsvXdDyCAUNLPbLP0ZMSBdQt+eedh3x7yxghrUSV5rYWESpXWVULJ6JIwzNX3Ve6Kii4ZNElA3xcywLYFBBC37Lk5AtR9cpAfSGmTqju88NrqxbGfafwSLn0rEShcEt+d/02++85GAh0Lr3TO7V/AJDqliooiDak4Zl7f15OrJyCa2b+cZiPpIRJcIkIIVC2vHvMnY3uxFYBcXl1dDsdqmipoj1P9oBqebJlih7/ZhRu5u23b3DA9uuNApTSqtHWm6JVQZQ05a/gxhCC8dSTFpe1CEm4mz/80/reOZSz6FP8fEJAGGLce/Sb0uB+phWh5QSMCnBRja2otPRFH7YkelyigIroq6cMX2/L7bdZGQCobCvwmBdr2rNFMrxgAkJ1Zz9fbnhG3RO7X7FLCFGJiz5dkp5BNfa/uHhRUweKakRLzdPh+kYNzEpoAomChMicJ564fOXNtt5s1THLRQA0QNDau1eYikCAzg/vdCL610vL30Oo7r2vn3skfASpzpAyHR5C7J74+YQSuhYYRhk0g0QBkCISJk++M15+tfGrrLXO+mPaBkYl4KRgMTR9UwCN3zoZFeTaqZt/1DPnjfISoSBKXM7Q8z6ui+ec8/sZLrv9ybJGYs+hhtEkEk0jEgL4KVOeAvovv8q48auNXXHYsOED4y5cIAqFDqdOqigbVoV/fPXc7ZC0UFhhW6Y03MTAOLnzzKeaPZJbMzRkOR4NqWfR52gaiQL5aiIi4JKPPnoScIOHD11h+KiVR6y53Ji1XVZ8QijU6OIbKlQG4R7f47snr6h0rb50eZ9PA8JURLj/oruSSPvILerUF2kqWtkXwBKzTvokTSVRoPVHFgGh8+bhtfTVs0/ObHtIQKOXf1X5Ioe6uZdMOOsrceKclBvbZbrrDB4xn//j1UtQUv7hMoFgbtZ3JVU0s7Z10WI0nURTWp/GIhBEua8dndGCCxSICk79pIpNX4rolf12P34bpGmIpSQLp5dm+r9KF+Oxq++Yjij0JUMwPetFdU++1r+ib4H9q93CsuzSpBJthQRcbvwlQ0NGvRMhoPGVt1Q3AQwuufWew7+1ecQkklKShVsTiUAGxJj/xE1/9HBVLTP2NohpWX5ucFf+qeJz9pVpfNk0uUQBQHHuaj5rqZwQH792evXnjxb99q87HrZ9C1TbshCzrGlbOIQAqIgc3rvzH08sRtTrtk9US5F90cujX4WPqr4yjS+f5peo02P2C1FhwJUCocPZU6uvbRBEpt9001f3+8yagKqIQPIViJZelMK08gPSEsBOIkx+5d6/TkEfs6ApH2RZUcEwJCa1GtP0EnW6/a8gGUsiQkGIL7muFg4SCae33bbGVntuP8YBDHCSbwfddselwVuSlAiATn7wrufeWgLHvrES2gHinewQ3ZhmqyqyDNDsEhUdcsbgjF3cIIQav3xOrS6kiMK779640k7bbbj68v2AvOu19Krpv5wAmPfJpBcfeGgagEj7nj4BEO/OHlH4smBcX8h+bDDNLlHiN9v6CIXPbCHoeNaU2pXwChBgynXXDR+3+urrrb/e8pkLCMnE1199/YMPPl6QqrfP3pALXtmmcKutw8YD5/fIcJZlmlyiUdjn+1l7RNNGovGVN9Y0DkgADnNefBGIR6yz7viVRo3o1zLAAUFDkls4e+p7H779/kIFANfH4xvJK9toxr0zeoMnLcOoxjS3RF1Y/fw4RIVubrre8sqZtb+kplve/PTpjwLo1y9uiQhV9cmSpWu16IPzzw5E4fHDWBjyVrfrk7aNoMY0t0S1/0WrZxQrAgFRwW8m16NSbT5tQgRgrn2tnPyCTG/YDVp/Xpo/RDN+l11+2e0vEhH5Zau6DGyZo0eq0ZdKhMO+mhYr6vSGQKju/66tZ0YKVZWAtAJQ1eSZonjtDRTkZIpgqx2L9e5sI6imvYNbP+WiOG7q+7BnaWYr6sJWp2SutxAA4/fPbkQBEtNkFowXPLpF4e/ifPy9/3b52BSu9rMlM2fPnj171qwF3oeg5pV0QzNLVEdcPNrH2XWMqO63by2zDRmaH8XtR0edZ6PCiN+6qngLZgCRP+QHrf+9cNbsOXNnz509Z/bshR8/Ubeh9naaWKJOj9k6XW/JWBIN8b2Xm4XrORQPvLV21l4XuWDbJcWdG+dHfxtJBAEEgwat0vbG3/ez520RmncO4HSn4zOaQ+Q3QUWzT0m67Adt1BfJ/QXaWYtCCVv9usvKY79cw7eIACBJ1RC8T5IluK+ug+3VNK1ERUddMDRxGfVQhECQ/3vKovs9ieCWhXFGwMjxRz9mQXPgPLHuewSjpTE456IojuO4vz5gLlExmleiOOFTviWrFTQhIX7x193+piKujWL3jFEpKi//E6Eg1EMhLjxOM8O64vwe12b0nRTFw2+bRIvRrBJ1+vmj4bKq4QiECCdPiYv+puJc6klpG+mtZFqtIYKrkpbCV+kUF1zcPyDq9E1Hjnrw9YPUFTZGU9wcrEhnMZo0XCS6wu8GZWXPgwBCfOPdRZvMOSUBGTxi9ZHjhsSRkGHhzE/mTZy1wLem7tV16H0FlYf/tY9GhXlfTuWYbU74X0BMbUvIcj5g7NnfRsbWfNGWafeYES1Ks0qUx26SuY0bQtF4zq9CZtRQhFSMHDduyw03HD2s/Yc5f84b773yzsdTpi8G4Gi3RA048yv9szYJOoYtJvzzmkfntb1Gqmy6/2HDyQJJgyBufcN2yBSlOSXq9AvHZEZzQQiJM17MCtE7khj35c+tt8byAEDN22BCIEOHrgpgxifvv/7Iw1PVjGn10L3wu+MyHFShuOD22ef5Rx9/8b25ABCvue6W2201CMEVerkAotwl9mMUpyklKjr84qHZbq4QGj31pwwjKKJYcbP99hwFIKgT6TDPJkFlNGrU+rv+6JOH//3MB7MhVi2nOohzvrJOKLSLQjgE2XTTIxcumTZ30YDhw4cMdICPooxEIoqP//CybY8pTnNKlMd8qqibS8H5swqMqFNyswN22jiGEuKiDgUT0o+KI5SAW3GffWa88ujtj9JUWhWMph//L5fh6giIiIHRoEHL5V8KdHHG1hhQQjy5iiqrfYBmlKjTjX9czM0FQ/z3v3f2iwQqmx22/zBocCKSpn12+Hg+NJwumitGbbfdMU9e87+P6SxDtHKCu/3C43yUUYgtFWlbpTbASZZA0wNO+9Bmol3QjBLVgRcv5+MshQolxFPO6NTBRUSx3eG7jYAX59rVwm3/8XzPprQBS0QlB22//cv3/u0ZVNIOxkghfrrpjklLVoVwSb9/af9C4ecFSctfft93i1eUQhOuizp8e4cQZVY7Jwj89eWO7qmjrnL+XQeMCBpFICWtj52NAAIS4iINutFx9125qaitlVYKXXLQWy1eKoyPE/Atr/zIOot2SfNJVHS1kzKr2KZFM6O3Lup4uNOhJ/zv+EEJI5c2OOz6BxeICETgIgl+xOET/rojiyasGd2g0Yd7TYsr1CghPp7yzZmWa90lzSdR4PQ1E4cMzyg1or+c3L5FT0Td5q7z1g7aApbey1dAIRFFGkYecNdl67HbfchGNiF65SvTYp/RzqMExMdz93nZJqJd03QSddzjOxpLRuYfCQluwj/bx4pcWO7827fxGuU7BJdsDYUCEM7Rtxw14bQRwQxpZQT35Jc/jD2l3LgbAR9P2+NRU2g3NJtERQce15Ld7FMgGvHyRUuH7KDb3nX8cj5yaYSoHJWlU1YKYoYxp/93ZzOkFaLRszs8G2tm57rikKIhfneXB02h3dF0EsUPtw8us78shSrXtzOiTgefecdnEkbSsSh16RdLWwg79Zvd9vvVgtnRigjR2zveGDkPlmxIU4covvcLz5lCu6XJJCq64YkQyYjfUEDEM37dJkUH3fD2U4b4WFCmAW13OQiFcJHv9/17dmKzfRu9hBDN+eaRc2MqSvR2KdAQ6Rm72oJoCTTdTXnM8l6yktyFIgE3vtQ6R3WK7/9nhwSRlNgStAhCASWSZP07ftW/iha2fZkguGKbO1wUVLovFkZSNETREzueprYrvwSa656M+KWD4DLDPgRDPOXS1necDr7o9yv72AnLiRJlIKlMW0L/n92yWpkzKiOFiF7e48AXY6fKrosmEqCqi98/adsHbCdDSTSXRMOIM/p7l71MKQAufj1Kf1WnG9zxIw2RlL7QUhyhEIzod71vBzbXF9JrCA5/+dxRr7rIBY+ippSA9y5yH/3ic+clltVVGk2VAOj0W5/Nag+RzkQZvfTHNFVMqLtfs3KQCMxO/SyTdErqxK9z28E3L1sp3YRmfEEhrrk8FNGCy/+02+FbjQCCpD9h69Mzv4JGQKMYi5++9paZ3XVNJkLhw5JlpUgQIetG6q4XD7PSEbUHnyfNJFGn446BSGHHLUAICe7aT5wCcIqf/WJgElc5C+10AaFEfui1q16csSTbe4lRWLwEiDC49pcK4hbdfPOmu3zxs0PSfy9tKEGIcxAAySP/vf8hwHWXltuSOW4UeTWTAeiX9XLUzeLawKyPRRgmPfXsbqa5l/CaQ5I4U3UUhvjZL84SAk5HXPFNagRKVv52pVAoCBFOPXNZsqOD18l6/DOe9V5dLudI9F9lq223XHPQoM7vLVg46dGHn/9gcUlbAEeMz/4N3p2X+XIWo1fJvswbi7v82KorZK2+Se71nrKjTSRR4RfuGKJZ+w/zTXr2vykKgNONL/2CMiosJVclaUNEcef/tKA+rFEyznkAGLXe2LGrjBw6KG5xSeIXzZ42bdI7b88CgJgWxu2tCG6ip1JZiDJwwiAAIth1MhOlZh9YDUolfWAdWiL2HC6bej6a0yZV6dVbBg7qHy19o/QLFxl3OcOo7BQVfqwv4LC/BqVmK1QTHpDuYjlyNnN1USipVGXwPLOZnIteiovilrY6nRK3xJHd5L0cwciXmTDbhioT3tcPiBCdTiZaxNbWRqNeeWiTLUb1Wlr7PhrLAA4/TLWXqdCgi7+EKMKomxg866XQVo1yztdNo4bRiWEvMXQxE72jBTHG/ZdJqI+Tu1SjVM9Zn4VtfDGMdjicTU/NmomqKj33QYQdXqtToKiTRpnw2VE2HzWMpThsNI0hU6GkMuFdEbB3a6CormganLrZrKhhLEVwEZMiAlUGXbwjcHzChHW2oW0a9fyJTUcNoxXB2jMYihhIVc+70O8aBt8AgeY1Gjh7K9OoYbRxA5Ns8amqBn51xO0M9Q0UtZcolZ5P2HTUMFIctltYZCaqVHres8bTTEIdF1s6X1VVE55qZtToeZriJlR8b6CXwobcSHegRIse+vMWPnK12BtaGiIChx991qowGD1OM7hyTrd4eIC6rE1oIETd9H7DgqvptpbuIIQh/t+Xcw27omFk0wxLC5TLNvZRkZLwQsgvJ26lmW2Y6oYAcLrGu8872/Ni9HkcdlysxZZElYFvDXF3FEsOrON8lJ7PLNcUbobRl2mCyRbxnf5FtsumJeMvmq+HPR+Htl54DRoVnd/8CJOo0edx2GIuQxETqfR8bWVEWO89Jg1ac1l67cBJa5lGjZ6l562o4sdDvcs0kCRI3PaxhOj1IxbGXtDAukIUurDqfiZRo48j+NzCotZRGThjEzggwuGNy11ovbgGvjLSNGr0bQSXFdviku7dvCq19IKfMjQweyHVqOcJTRH0NoyewmGdj+iL5/5xzuZtZuwq5orl8dZJoUz4/IpmRo2+jOD84jvMlJ43t7Qd2f965upWEyVToqre72USNfowgvWmFAvnqlI9v90W0RKMfLSOdYuyrs+EL48xiRp9GIefFS3MSWXCp4ctVYjDuCeZa9R0VKkaNNmzCYLehtFzDHqmi2IL6vnD9tEahw0+SKsENmbTKBNeaTbU6MtEOJRFa+eqKt9ZrdPx233YGI3mFfrm6iZRow8jGPpYsa3cabDoik6fiPCVhfTZ1XZrrVEGze1hSy5GX0awVxKKZCOoUkOya+eZoMMRvgEaVaVqwrPMhhp9GsH/FVsTTYNFE/oVaETwE4ZiBXdrqFFqwgmDTaJGX0aw9lQWXRNVDTy4sP+pAL9iqHcpXVUmfH1Ni+YafRqHC4tvA1UGvp61JinAJfR1taOqpOeCnW0iavRpBKu9U9TP1TRYlOVnCvpdS69pob76CFQ16OLvmpdr9G0Eh9IXCxZR1XP3bJEI3F/TzhH1kGjaeSnwBFOo0ddxt9EXS4tXJnxkSBGVOAz9Z70qpSiVDIFniUnU6NsINpxbdEKpVM9DC4NFbZ/td2N9OjClufOBv2rod2EYTYjD5UWNqCoD31+7eEDVYegN9FrzPCOlkj7w3NhsqNHHEYyd2MWiqAZe39WKhwB/oK/xFm/Nm2+e2bCvwTCaFYfvarH03DSee2CXhsxhwNU17tidOs4JF/zEmQ01DPy1aHquKgOnrNz1xwX4NfO5gDURabqMk3DBvo35+w2jmRGMnVK0XSGVCc/vzpI54BehZkGj1KCHhC/sBGc21OjzOBzX1R6XwIXbdJvbI8AhC5nUJGiUFnPwgf9eybL+DAPAgBfpi+UeqHo+OLyE+aDgS68wCcXaTZQjUKWGhAtPH2BZf4YBOOy4qGh2kKp6nl+SMXMY/yB9WuSzcpW2zkL58k7NUPzbMHoewZlFk//S9IGdS9OKw/CLmDq7FYo0TSTUkHDOpatZJNcwAEAw5P60R0u2aAJfG1TiqRxw0BQGX2nUKJ2EBk8+tl1z9HI0jJ5Aosp0AAAFfklEQVTHYctFxbtEKBOeXLLDKYJNbiET1bLdXU0LJKkm5Cs/HGKRXMPIIzi3eDyXGjh/szLmhA743oet3m7pIs3bXfWenHnGaDOhhrGU5d4quiiqVM8HR5QzKxRgvavmUssQqWregHpPTrxwM5gJNYw2HHZeUrw5i6rnb8qM2zhg6zuUmoRW57Ub87lUn/zgzHEmUMNoj8OZxQtcK1WTr5W79iEC7HvbAtInga0S7EKeVE0SJWfdfvT49NOGYeQRDLivi7wFBk4cVf5ZHRB/9rrpZGsug2ZDVdXgE5K5187duB8QmUANoz0OG88o1muptadoJapxADY66a4ZJNX7xIfCh4CG4L0PJDnnwfP2HA7AWa6CYXTE4VDmik1FVdVz5wpTCESAQese+b+ZniTpk8R7H/J4n+TS17lw4k3f3WgYbApqND89covKrXuGiEWuTbr3tv1IWNmpHRTA2htuuNYaY0YtV/j+vJkff/DRWy++OhuAOK3wKobRMHpEoms8OYrFLk2E+Lb9clWcXUAAGLLciOXHj115xODhg/oPEPg5c6Z/9M5b0+fOmhcAiBCmT6MXUKyAVx0Rbr6cFns0EBA8m6vUiLaeQqDz509K/+3iKAI059sGIFCaPo3eQY9I9NNOhZkipRDR4sfhQlWXIIG0yCYJbTPJkr5i8jR6ET0gUW35FEhkalQoIfrgaWj1l8lwZE2bRu+j8SsODuM3gBQpJE0h8PhMZ1oyjJTGS1SwxaqhaJSKENzTyOEYRnPTeIkqtkOxqSgAuKlP1MLPNYxlg4ZLVDjiM3AouuJBvDK1oQMyjKamB8JFa64LV9yIEs8vaORoDKO56YEE1Q0GazEjSgB41Sp8GUYbPaCGTVvXLAsRMJrzQoPHYxjNTMMlymgdoKgVFeKdNywzzzDaaLREBaPWTf8/A4LEs/Mik6hhtNJ4ia6/ShdvIsLjDRyNYTQ9jZaowyaDQrFVUQIyuybZf4axrNBoiQZsCZUuVkU/mGhTUcNYSoMlKhy+PhyLlfMS4t35jR2RYTQ3jZYoVh6HrowoXk+sVolhLKXBEiXWWJ7FVkUBAK83bjCG0Qto+Lro2OIbzQhEi9+y5mSG0Y6GS3R88WiQQDHxfYsWGUY7Gu3oujWKlzSjEG9OMYkaRjsabUUHrIJipcMIAq/S+pMZRjsaLdGhKxe1ogI4vNbY4RhGs9NYiQoGDenKz3Xz3zI/1zDa01iJEvPngF0UmZ76nknUMNrTaEd3ztuAZE5HCQCT55hEDaM9jc4uyt0PpTBDowIA06vpFGEYyyANXxe9dUqcVReFIKB4w9L/DKNHcfgJvVLZob2oUlXpOffTlltkGD1My63MpZLsoFDSBx5vlcUMo4cRrPtGqtG8Hc3LVRPyoh5qpmgYxlIcNn6bOWVepKlC1Sf0JzpTqGH0PA6bP8/Ep96tqlI15Mhn9zIbahhNgcNK/0d6r6qqGrxXcuIJy8OZQg2jKXCQH71OapIkSSC5+Ikz1+6RqtuGYWQiwKrHP7OEJDn5wfO+uBxgG1wMI4ue8i2dYvC2647CvInPvwFAxCpzGkZzsdRsRjYHNYxi9KA6xIEQ0OynYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRiGYRhG/fh/JOg9CE1EsmYAAAAASUVORK5CYII=" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" id="e5820d0b84" height="500" preserveAspectRatio="xMidYMid meet"/></defs><rect x="-18" width="216" fill="#ffffff" y="-7.5" height="89.999996" fill-opacity="1"/><rect x="-18" width="216" fill="#ffffff" y="-7.5" height="89.999996" fill-opacity="1"/><rect x="-18" width="216" fill="#ffffff" y="-7.5" height="89.999996" fill-opacity="1"/><g clip-path="url(#294e9b1262)"><g mask="url(#124efb07be)"><g transform="matrix(0.125, 0, 0, 0.1245, 25.065686, -5.884486)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(19.285774, 66.060111)"><g><path d="M 4.75 0.15625 C 4.007812 0.15625 3.347656 0.0664062 2.765625 -0.109375 C 2.179688 -0.296875 1.695312 -0.539062 1.3125 -0.84375 C 0.925781 -1.144531 0.632812 -1.472656 0.4375 -1.828125 L 1.59375 -3.25 L 1.78125 -3.25 C 2.101562 -2.769531 2.507812 -2.382812 3 -2.09375 C 3.5 -1.8125 4.082031 -1.671875 4.75 -1.671875 C 5.3125 -1.671875 5.734375 -1.789062 6.015625 -2.03125 C 6.304688 -2.269531 6.453125 -2.601562 6.453125 -3.03125 C 6.453125 -3.28125 6.40625 -3.488281 6.3125 -3.65625 C 6.226562 -3.832031 6.078125 -3.976562 5.859375 -4.09375 C 5.640625 -4.21875 5.347656 -4.328125 4.984375 -4.421875 L 3.609375 -4.734375 C 2.648438 -4.953125 1.929688 -5.316406 1.453125 -5.828125 C 0.984375 -6.335938 0.75 -7 0.75 -7.8125 C 0.75 -8.414062 0.898438 -8.945312 1.203125 -9.40625 C 1.503906 -9.863281 1.945312 -10.21875 2.53125 -10.46875 C 3.113281 -10.726562 3.804688 -10.859375 4.609375 -10.859375 C 5.429688 -10.859375 6.132812 -10.75 6.71875 -10.53125 C 7.3125 -10.3125 7.8125 -9.976562 8.21875 -9.53125 L 7.171875 -8.09375 L 6.984375 -8.09375 C 6.679688 -8.414062 6.332031 -8.65625 5.9375 -8.8125 C 5.550781 -8.96875 5.109375 -9.046875 4.609375 -9.046875 C 4.023438 -9.046875 3.582031 -8.941406 3.28125 -8.734375 C 2.976562 -8.535156 2.828125 -8.253906 2.828125 -7.890625 C 2.828125 -7.554688 2.929688 -7.289062 3.140625 -7.09375 C 3.359375 -6.894531 3.726562 -6.738281 4.25 -6.625 L 5.65625 -6.328125 C 6.695312 -6.109375 7.453125 -5.734375 7.921875 -5.203125 C 8.390625 -4.679688 8.625 -4 8.625 -3.15625 C 8.625 -2.488281 8.476562 -1.90625 8.1875 -1.40625 C 7.894531 -0.914062 7.457031 -0.53125 6.875 -0.25 C 6.300781 0.0195312 5.59375 0.15625 4.75 0.15625 Z M 4.75 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(28.477805, 66.060111)"><g><path d="M 5.25 -10.703125 C 6.988281 -10.703125 8.3125 -10.253906 9.21875 -9.359375 C 10.132812 -8.460938 10.59375 -7.128906 10.59375 -5.359375 C 10.59375 -3.585938 10.132812 -2.25 9.21875 -1.34375 C 8.3125 -0.445312 6.988281 0 5.25 0 L 1.390625 0 L 1.390625 -10.703125 Z M 5.125 -1.78125 C 6.226562 -1.78125 7.050781 -2.0625 7.59375 -2.625 C 8.144531 -3.1875 8.421875 -4.097656 8.421875 -5.359375 C 8.421875 -6.609375 8.144531 -7.515625 7.59375 -8.078125 C 7.050781 -8.640625 6.226562 -8.921875 5.125 -8.921875 L 3.515625 -8.921875 L 3.515625 -1.78125 Z M 5.125 -1.78125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(39.91662, 66.060111)"><g><path d="M 1.390625 0 L 1.390625 -10.703125 L 3.515625 -10.703125 L 3.515625 -6.328125 L 3.75 -6.328125 L 7.3125 -10.703125 L 9.484375 -10.703125 L 9.484375 -10.53125 L 5.546875 -5.65625 L 9.890625 -0.1875 L 9.890625 0 L 7.5 0 L 3.75 -4.625 L 3.515625 -4.625 L 3.515625 0 Z M 1.390625 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(49.803914, 66.060111)"><g><path d="M 3.78125 0.15625 C 3.226562 0.15625 2.722656 0.09375 2.265625 -0.03125 C 1.804688 -0.164062 1.410156 -0.347656 1.078125 -0.578125 C 0.753906 -0.804688 0.515625 -1.066406 0.359375 -1.359375 L 1.5 -2.578125 L 1.640625 -2.578125 C 1.910156 -2.210938 2.226562 -1.9375 2.59375 -1.75 C 2.96875 -1.570312 3.367188 -1.484375 3.796875 -1.484375 C 4.191406 -1.484375 4.488281 -1.550781 4.6875 -1.6875 C 4.882812 -1.832031 4.984375 -2.039062 4.984375 -2.3125 C 4.984375 -2.507812 4.910156 -2.675781 4.765625 -2.8125 C 4.628906 -2.957031 4.398438 -3.070312 4.078125 -3.15625 L 3 -3.40625 C 2.195312 -3.59375 1.613281 -3.882812 1.25 -4.28125 C 0.882812 -4.675781 0.703125 -5.175781 0.703125 -5.78125 C 0.703125 -6.28125 0.828125 -6.710938 1.078125 -7.078125 C 1.335938 -7.453125 1.695312 -7.738281 2.15625 -7.9375 C 2.625 -8.132812 3.171875 -8.234375 3.796875 -8.234375 C 4.523438 -8.234375 5.128906 -8.128906 5.609375 -7.921875 C 6.085938 -7.710938 6.457031 -7.429688 6.71875 -7.078125 L 5.640625 -5.90625 L 5.5 -5.90625 C 5.269531 -6.15625 5.015625 -6.335938 4.734375 -6.453125 C 4.453125 -6.578125 4.140625 -6.640625 3.796875 -6.640625 C 2.992188 -6.640625 2.59375 -6.390625 2.59375 -5.890625 C 2.59375 -5.679688 2.664062 -5.507812 2.8125 -5.375 C 2.96875 -5.238281 3.234375 -5.128906 3.609375 -5.046875 L 4.59375 -4.828125 C 5.414062 -4.660156 6.015625 -4.378906 6.390625 -3.984375 C 6.773438 -3.597656 6.96875 -3.078125 6.96875 -2.421875 C 6.96875 -1.910156 6.835938 -1.457031 6.578125 -1.0625 C 6.328125 -0.675781 5.960938 -0.375 5.484375 -0.15625 C 5.003906 0.0507812 4.4375 0.15625 3.78125 0.15625 Z M 3.78125 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(57.24683, 66.060111)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(60.78167, 66.060111)"><g><path d="M 3.15625 0.15625 C 2.632812 0.15625 2.179688 0.0625 1.796875 -0.125 C 1.421875 -0.320312 1.128906 -0.601562 0.921875 -0.96875 C 0.710938 -1.34375 0.609375 -1.785156 0.609375 -2.296875 C 0.609375 -2.773438 0.710938 -3.175781 0.921875 -3.5 C 1.128906 -3.820312 1.445312 -4.085938 1.875 -4.296875 C 2.300781 -4.503906 2.863281 -4.664062 3.5625 -4.78125 C 4.039062 -4.863281 4.40625 -4.945312 4.65625 -5.03125 C 4.914062 -5.125 5.085938 -5.226562 5.171875 -5.34375 C 5.253906 -5.46875 5.296875 -5.617188 5.296875 -5.796875 C 5.296875 -6.054688 5.207031 -6.253906 5.03125 -6.390625 C 4.851562 -6.523438 4.550781 -6.59375 4.125 -6.59375 C 3.675781 -6.59375 3.25 -6.492188 2.84375 -6.296875 C 2.4375 -6.097656 2.085938 -5.835938 1.796875 -5.515625 L 1.640625 -5.515625 L 0.796875 -6.796875 C 1.203125 -7.242188 1.703125 -7.59375 2.296875 -7.84375 C 2.890625 -8.101562 3.535156 -8.234375 4.234375 -8.234375 C 5.304688 -8.234375 6.078125 -8.003906 6.546875 -7.546875 C 7.023438 -7.097656 7.265625 -6.457031 7.265625 -5.625 L 7.265625 -2.109375 C 7.265625 -1.742188 7.425781 -1.5625 7.75 -1.5625 C 7.875 -1.5625 7.992188 -1.585938 8.109375 -1.640625 L 8.203125 -1.609375 L 8.359375 -0.1875 C 8.242188 -0.113281 8.085938 -0.0507812 7.890625 0 C 7.691406 0.0390625 7.472656 0.0625 7.234375 0.0625 C 6.742188 0.0625 6.363281 -0.03125 6.09375 -0.21875 C 5.820312 -0.40625 5.628906 -0.695312 5.515625 -1.09375 L 5.359375 -1.109375 C 4.960938 -0.265625 4.226562 0.15625 3.15625 0.15625 Z M 3.796875 -1.359375 C 4.265625 -1.359375 4.640625 -1.515625 4.921875 -1.828125 C 5.203125 -2.148438 5.34375 -2.59375 5.34375 -3.15625 L 5.34375 -3.96875 L 5.203125 -4 C 5.078125 -3.90625 4.914062 -3.820312 4.71875 -3.75 C 4.519531 -3.6875 4.238281 -3.625 3.875 -3.5625 C 3.425781 -3.488281 3.101562 -3.363281 2.90625 -3.1875 C 2.71875 -3.007812 2.625 -2.753906 2.625 -2.421875 C 2.625 -2.078125 2.726562 -1.8125 2.9375 -1.625 C 3.144531 -1.445312 3.429688 -1.359375 3.796875 -1.359375 Z M 3.796875 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(69.293086, 66.060111)"><g><path d="M 1.171875 0 L 1.171875 -8.078125 L 3.109375 -8.078125 L 3.109375 -6.890625 L 3.265625 -6.859375 C 3.765625 -7.773438 4.582031 -8.234375 5.71875 -8.234375 C 6.644531 -8.234375 7.328125 -7.976562 7.765625 -7.46875 C 8.203125 -6.957031 8.421875 -6.21875 8.421875 -5.25 L 8.421875 0 L 6.390625 0 L 6.390625 -5 C 6.390625 -5.539062 6.28125 -5.925781 6.0625 -6.15625 C 5.851562 -6.394531 5.515625 -6.515625 5.046875 -6.515625 C 4.460938 -6.515625 4.003906 -6.328125 3.671875 -5.953125 C 3.347656 -5.578125 3.1875 -4.988281 3.1875 -4.1875 L 3.1875 0 Z M 1.171875 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(78.748583, 66.060111)"><g><path d="M 3.984375 0.15625 C 3.347656 0.15625 2.785156 0 2.296875 -0.3125 C 1.804688 -0.625 1.421875 -1.09375 1.140625 -1.71875 C 0.859375 -2.34375 0.71875 -3.113281 0.71875 -4.03125 C 0.71875 -4.957031 0.859375 -5.734375 1.140625 -6.359375 C 1.429688 -6.984375 1.828125 -7.453125 2.328125 -7.765625 C 2.835938 -8.078125 3.425781 -8.234375 4.09375 -8.234375 C 4.59375 -8.234375 5.023438 -8.144531 5.390625 -7.96875 C 5.765625 -7.800781 6.078125 -7.53125 6.328125 -7.15625 L 6.484375 -7.203125 L 6.484375 -11.328125 L 8.515625 -11.328125 L 8.515625 0 L 6.484375 0 L 6.484375 -1.046875 L 6.328125 -1.078125 C 6.109375 -0.691406 5.800781 -0.390625 5.40625 -0.171875 C 5.019531 0.046875 4.546875 0.15625 3.984375 0.15625 Z M 4.65625 -1.5625 C 5.226562 -1.5625 5.675781 -1.765625 6 -2.171875 C 6.332031 -2.585938 6.5 -3.207031 6.5 -4.03125 C 6.5 -4.863281 6.332031 -5.484375 6 -5.890625 C 5.675781 -6.304688 5.226562 -6.515625 4.65625 -6.515625 C 4.050781 -6.515625 3.59375 -6.3125 3.28125 -5.90625 C 2.96875 -5.507812 2.8125 -4.882812 2.8125 -4.03125 C 2.8125 -3.1875 2.96875 -2.5625 3.28125 -2.15625 C 3.59375 -1.757812 4.050781 -1.5625 4.65625 -1.5625 Z M 4.65625 -1.5625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(88.423635, 66.060111)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(91.958475, 66.060111)"><g><path d="M 10.28125 0 L 8.046875 0 L 7.25 -2.46875 L 3.140625 -2.46875 L 2.34375 0 L 0.15625 0 L 3.859375 -10.703125 L 6.578125 -10.703125 Z M 5.09375 -8.46875 L 3.71875 -4.25 L 6.65625 -4.25 L 5.28125 -8.46875 Z M 5.09375 -8.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(102.387337, 66.060111)"><g><path d="M 5.53125 -10.703125 C 6.300781 -10.703125 6.957031 -10.5625 7.5 -10.28125 C 8.039062 -10 8.445312 -9.601562 8.71875 -9.09375 C 9 -8.59375 9.140625 -8.007812 9.140625 -7.34375 C 9.140625 -6.675781 9 -6.085938 8.71875 -5.578125 C 8.445312 -5.078125 8.039062 -4.6875 7.5 -4.40625 C 6.957031 -4.125 6.300781 -3.984375 5.53125 -3.984375 L 3.515625 -3.984375 L 3.515625 0 L 1.390625 0 L 1.390625 -10.703125 Z M 5.25 -5.671875 C 6.425781 -5.671875 7.015625 -6.226562 7.015625 -7.34375 C 7.015625 -8.46875 6.425781 -9.03125 5.25 -9.03125 L 3.515625 -9.03125 L 3.515625 -5.671875 Z M 5.25 -5.671875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(112.164848, 66.060111)"><g><path d="M 3.515625 0 L 1.390625 0 L 1.390625 -10.703125 L 3.515625 -10.703125 Z M 3.515625 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(117.068241, 66.060111)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(120.60308, 66.060111)"><g><path d="M 5.25 -10.703125 C 6.988281 -10.703125 8.3125 -10.253906 9.21875 -9.359375 C 10.132812 -8.460938 10.59375 -7.128906 10.59375 -5.359375 C 10.59375 -3.585938 10.132812 -2.25 9.21875 -1.34375 C 8.3125 -0.445312 6.988281 0 5.25 0 L 1.390625 0 L 1.390625 -10.703125 Z M 5.125 -1.78125 C 6.226562 -1.78125 7.050781 -2.0625 7.59375 -2.625 C 8.144531 -3.1875 8.421875 -4.097656 8.421875 -5.359375 C 8.421875 -6.609375 8.144531 -7.515625 7.59375 -8.078125 C 7.050781 -8.640625 6.226562 -8.921875 5.125 -8.921875 L 3.515625 -8.921875 L 3.515625 -1.78125 Z M 5.125 -1.78125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(132.041895, 66.060111)"><g><path d="M 4.6875 0.15625 C 3.90625 0.15625 3.210938 -0.00390625 2.609375 -0.328125 C 2.015625 -0.660156 1.550781 -1.140625 1.21875 -1.765625 C 0.882812 -2.390625 0.71875 -3.144531 0.71875 -4.03125 C 0.71875 -4.925781 0.882812 -5.6875 1.21875 -6.3125 C 1.550781 -6.945312 2.015625 -7.425781 2.609375 -7.75 C 3.210938 -8.070312 3.90625 -8.234375 4.6875 -8.234375 C 5.476562 -8.234375 6.171875 -8.070312 6.765625 -7.75 C 7.367188 -7.425781 7.835938 -6.945312 8.171875 -6.3125 C 8.503906 -5.6875 8.671875 -4.925781 8.671875 -4.03125 C 8.671875 -3.144531 8.503906 -2.390625 8.171875 -1.765625 C 7.835938 -1.140625 7.367188 -0.660156 6.765625 -0.328125 C 6.171875 -0.00390625 5.476562 0.15625 4.6875 0.15625 Z M 4.6875 -1.5625 C 5.945312 -1.5625 6.578125 -2.382812 6.578125 -4.03125 C 6.578125 -4.882812 6.414062 -5.507812 6.09375 -5.90625 C 5.769531 -6.3125 5.300781 -6.515625 4.6875 -6.515625 C 3.4375 -6.515625 2.8125 -5.6875 2.8125 -4.03125 C 2.8125 -2.382812 3.4375 -1.5625 4.6875 -1.5625 Z M 4.6875 -1.5625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(141.424207, 66.060111)"><g><path d="M 4.703125 0.15625 C 3.921875 0.15625 3.226562 -0.00390625 2.625 -0.328125 C 2.03125 -0.660156 1.5625 -1.140625 1.21875 -1.765625 C 0.882812 -2.390625 0.71875 -3.144531 0.71875 -4.03125 C 0.71875 -4.925781 0.882812 -5.6875 1.21875 -6.3125 C 1.5625 -6.945312 2.03125 -7.425781 2.625 -7.75 C 3.21875 -8.070312 3.898438 -8.234375 4.671875 -8.234375 C 6.378906 -8.234375 7.472656 -7.613281 7.953125 -6.375 L 6.5625 -5.390625 L 6.40625 -5.390625 C 6.238281 -5.765625 6.019531 -6.046875 5.75 -6.234375 C 5.488281 -6.421875 5.128906 -6.515625 4.671875 -6.515625 C 4.085938 -6.515625 3.628906 -6.3125 3.296875 -5.90625 C 2.972656 -5.5 2.8125 -4.875 2.8125 -4.03125 C 2.8125 -3.207031 2.976562 -2.585938 3.3125 -2.171875 C 3.644531 -1.765625 4.109375 -1.5625 4.703125 -1.5625 C 5.148438 -1.5625 5.523438 -1.679688 5.828125 -1.921875 C 6.128906 -2.160156 6.347656 -2.5 6.484375 -2.9375 L 6.640625 -2.953125 L 8.078125 -2.171875 C 7.867188 -1.484375 7.488281 -0.921875 6.9375 -0.484375 C 6.382812 -0.0546875 5.640625 0.15625 4.703125 0.15625 Z M 4.703125 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(149.745343, 66.060111)"><g><path d="M 3.78125 0.15625 C 3.226562 0.15625 2.722656 0.09375 2.265625 -0.03125 C 1.804688 -0.164062 1.410156 -0.347656 1.078125 -0.578125 C 0.753906 -0.804688 0.515625 -1.066406 0.359375 -1.359375 L 1.5 -2.578125 L 1.640625 -2.578125 C 1.910156 -2.210938 2.226562 -1.9375 2.59375 -1.75 C 2.96875 -1.570312 3.367188 -1.484375 3.796875 -1.484375 C 4.191406 -1.484375 4.488281 -1.550781 4.6875 -1.6875 C 4.882812 -1.832031 4.984375 -2.039062 4.984375 -2.3125 C 4.984375 -2.507812 4.910156 -2.675781 4.765625 -2.8125 C 4.628906 -2.957031 4.398438 -3.070312 4.078125 -3.15625 L 3 -3.40625 C 2.195312 -3.59375 1.613281 -3.882812 1.25 -4.28125 C 0.882812 -4.675781 0.703125 -5.175781 0.703125 -5.78125 C 0.703125 -6.28125 0.828125 -6.710938 1.078125 -7.078125 C 1.335938 -7.453125 1.695312 -7.738281 2.15625 -7.9375 C 2.625 -8.132812 3.171875 -8.234375 3.796875 -8.234375 C 4.523438 -8.234375 5.128906 -8.128906 5.609375 -7.921875 C 6.085938 -7.710938 6.457031 -7.429688 6.71875 -7.078125 L 5.640625 -5.90625 L 5.5 -5.90625 C 5.269531 -6.15625 5.015625 -6.335938 4.734375 -6.453125 C 4.453125 -6.578125 4.140625 -6.640625 3.796875 -6.640625 C 2.992188 -6.640625 2.59375 -6.390625 2.59375 -5.890625 C 2.59375 -5.679688 2.664062 -5.507812 2.8125 -5.375 C 2.96875 -5.238281 3.234375 -5.128906 3.609375 -5.046875 L 4.59375 -4.828125 C 5.414062 -4.660156 6.015625 -4.378906 6.390625 -3.984375 C 6.773438 -3.597656 6.96875 -3.078125 6.96875 -2.421875 C 6.96875 -1.910156 6.835938 -1.457031 6.578125 -1.0625 C 6.328125 -0.675781 5.960938 -0.375 5.484375 -0.15625 C 5.003906 0.0507812 4.4375 0.15625 3.78125 0.15625 Z M 3.78125 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(157.180298, 66.060111)"><g/></g></g><g clip-path="url(#eb5ffb5b46)"><g mask="url(#88dfb3f4a0)"><g transform="matrix(0.189516, 0, 0, 0.189, -6.315875, -21.98915)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></g></svg>
diff --git a/docs/en/docs/img/sponsors/porter-banner.png b/docs/en/docs/img/sponsors/porter-banner.png
new file mode 100755
index 000000000..fa2e741c0
Binary files /dev/null and b/docs/en/docs/img/sponsors/porter-banner.png differ
diff --git a/docs/en/docs/img/sponsors/porter.png b/docs/en/docs/img/sponsors/porter.png
new file mode 100755
index 000000000..582a15156
Binary files /dev/null and b/docs/en/docs/img/sponsors/porter.png differ
diff --git a/docs/en/docs/img/sponsors/speakeasy.png b/docs/en/docs/img/sponsors/speakeasy.png
new file mode 100644
index 000000000..001b4b4ca
Binary files /dev/null and b/docs/en/docs/img/sponsors/speakeasy.png differ
diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png
new file mode 100644
index 000000000..aa085f88d
Binary files /dev/null and b/docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png differ
diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png
new file mode 100644
index 000000000..672ef1d2b
Binary files /dev/null and b/docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png differ
diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png
new file mode 100644
index 000000000..81340fbec
Binary files /dev/null and b/docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png differ
diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png
new file mode 100644
index 000000000..fc2302aa7
Binary files /dev/null and b/docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png differ
diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png
new file mode 100644
index 000000000..674dd0b2e
Binary files /dev/null and b/docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png differ
diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md
index ebd74bc8f..3660e74e3 100644
--- a/docs/en/docs/index.md
+++ b/docs/en/docs/index.md
@@ -1,3 +1,12 @@
+---
+hide:
+  - navigation
+---
+
+<style>
+.md-content .md-typeset h1 { display: none; }
+</style>
+
 <p align="center">
   <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
 </p>
@@ -27,7 +36,7 @@
 
 ---
 
-FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.7+ based on standard Python type hints.
+FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints.
 
 The key features are:
 
@@ -115,7 +124,7 @@ If you are building a <abbr title="Command Line Interface">CLI</abbr> app to be
 
 ## Requirements
 
-Python 3.7+
+Python 3.8+
 
 FastAPI stands on the shoulders of giants:
 
@@ -331,7 +340,7 @@ You do that with standard modern Python types.
 
 You don't have to learn a new syntax, the methods or classes of a specific library, etc.
 
-Just standard **Python 3.7+**.
+Just standard **Python 3.8+**.
 
 For example, for an `int`:
 
diff --git a/docs/en/docs/js/chat.js b/docs/en/docs/js/chat.js
deleted file mode 100644
index debdef4da..000000000
--- a/docs/en/docs/js/chat.js
+++ /dev/null
@@ -1,3 +0,0 @@
-((window.gitter = {}).chat = {}).options = {
-    room: 'tiangolo/fastapi'
-};
diff --git a/docs/en/docs/learn/index.md b/docs/en/docs/learn/index.md
new file mode 100644
index 000000000..d056fb320
--- /dev/null
+++ b/docs/en/docs/learn/index.md
@@ -0,0 +1,5 @@
+# Learn
+
+Here are the introductory sections and the tutorials to learn **FastAPI**.
+
+You could consider this a **book**, a **course**, the **official** and recommended way to learn FastAPI. 😎
diff --git a/docs/en/docs/python-types.md b/docs/en/docs/python-types.md
index 693613a36..cdd22ea4a 100644
--- a/docs/en/docs/python-types.md
+++ b/docs/en/docs/python-types.md
@@ -182,7 +182,7 @@ For example, let's define a variable to be a `list` of `str`.
     {!> ../../../docs_src/python_types/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     From `typing`, import `List` (with a capital `L`):
 
@@ -230,7 +230,7 @@ You would do the same to declare `tuple`s and `set`s:
     {!> ../../../docs_src/python_types/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial007.py!}
@@ -255,7 +255,7 @@ The second type parameter is for the values of the `dict`:
     {!> ../../../docs_src/python_types/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008.py!}
@@ -281,7 +281,7 @@ In Python 3.10 there's also a **new syntax** where you can put the possible type
     {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008b.py!}
@@ -311,13 +311,13 @@ This also means that in Python 3.10, you can use `Something | None`:
     {!> ../../../docs_src/python_types/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009.py!}
     ```
 
-=== "Python 3.6+ alternative"
+=== "Python 3.8+ alternative"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009b.py!}
@@ -375,10 +375,10 @@ These types that take type parameters in square brackets are called **Generic ty
     * `set`
     * `dict`
 
-    And the same as with Python 3.6, from the `typing` module:
+    And the same as with Python 3.8, from the `typing` module:
 
     * `Union`
-    * `Optional` (the same as with Python 3.6)
+    * `Optional` (the same as with Python 3.8)
     * ...and others.
 
     In Python 3.10, as an alternative to using the generics `Union` and `Optional`, you can use the <abbr title='also called "bitwise or operator", but that meaning is not relevant here'>vertical bar (`|`)</abbr> to declare unions of types, that's a lot better and simpler.
@@ -392,13 +392,13 @@ These types that take type parameters in square brackets are called **Generic ty
     * `set`
     * `dict`
 
-    And the same as with Python 3.6, from the `typing` module:
+    And the same as with Python 3.8, from the `typing` module:
 
     * `Union`
     * `Optional`
     * ...and others.
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     * `List`
     * `Tuple`
@@ -458,7 +458,7 @@ An example from the official Pydantic docs:
     {!> ../../../docs_src/python_types/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/python_types/tutorial011.py!}
@@ -486,7 +486,7 @@ Python also has a feature that allows putting **additional metadata** in these t
     {!> ../../../docs_src/python_types/tutorial013_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     In versions below Python 3.9, you import `Annotated` from `typing_extensions`.
 
diff --git a/docs/en/docs/reference/apirouter.md b/docs/en/docs/reference/apirouter.md
new file mode 100644
index 000000000..b779ad291
--- /dev/null
+++ b/docs/en/docs/reference/apirouter.md
@@ -0,0 +1,25 @@
+# `APIRouter` class
+
+Here's the reference information for the `APIRouter` class, with all its parameters,
+attributes and methods.
+
+You can import the `APIRouter` class directly from `fastapi`:
+
+```python
+from fastapi import APIRouter
+```
+
+::: fastapi.APIRouter
+    options:
+        members:
+            - websocket
+            - include_router
+            - get
+            - put
+            - post
+            - delete
+            - options
+            - head
+            - patch
+            - trace
+            - on_event
diff --git a/docs/en/docs/reference/background.md b/docs/en/docs/reference/background.md
new file mode 100644
index 000000000..e0c0be899
--- /dev/null
+++ b/docs/en/docs/reference/background.md
@@ -0,0 +1,13 @@
+# Background Tasks - `BackgroundTasks`
+
+You can declare a parameter in a *path operation function* or dependency function
+with the type `BackgroundTasks`, and then you can use it to schedule the execution
+of background tasks after the response is sent.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import BackgroundTasks
+```
+
+::: fastapi.BackgroundTasks
diff --git a/docs/en/docs/reference/dependencies.md b/docs/en/docs/reference/dependencies.md
new file mode 100644
index 000000000..099968267
--- /dev/null
+++ b/docs/en/docs/reference/dependencies.md
@@ -0,0 +1,32 @@
+# Dependencies - `Depends()` and `Security()`
+
+## `Depends()`
+
+Dependencies are handled mainly with the special function `Depends()` that takes a
+callable.
+
+Here is the reference for it and its parameters.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import Depends
+```
+
+::: fastapi.Depends
+
+## `Security()`
+
+For many scenarios, you can handle security (authorization, authentication, etc.) with
+dependencies, using `Depends()`.
+
+But when you want to also declare OAuth2 scopes, you can use `Security()` instead of
+`Depends()`.
+
+You can import `Security()` directly from `fastapi`:
+
+```python
+from fastapi import Security
+```
+
+::: fastapi.Security
diff --git a/docs/en/docs/reference/encoders.md b/docs/en/docs/reference/encoders.md
new file mode 100644
index 000000000..28df2e43a
--- /dev/null
+++ b/docs/en/docs/reference/encoders.md
@@ -0,0 +1,3 @@
+# Encoders - `jsonable_encoder`
+
+::: fastapi.encoders.jsonable_encoder
diff --git a/docs/en/docs/reference/exceptions.md b/docs/en/docs/reference/exceptions.md
new file mode 100644
index 000000000..adc9b91ce
--- /dev/null
+++ b/docs/en/docs/reference/exceptions.md
@@ -0,0 +1,22 @@
+# Exceptions - `HTTPException` and `WebSocketException`
+
+These are the exceptions that you can raise to show errors to the client.
+
+When you raise an exception, as would happen with normal Python, the rest of the
+excecution is aborted. This way you can raise these exceptions from anywhere in the
+code to abort a request and show the error to the client.
+
+You can use:
+
+* `HTTPException`
+* `WebSocketException`
+
+These exceptions can be imported directly from `fastapi`:
+
+```python
+from fastapi import HTTPException, WebSocketException
+```
+
+::: fastapi.HTTPException
+
+::: fastapi.WebSocketException
diff --git a/docs/en/docs/reference/fastapi.md b/docs/en/docs/reference/fastapi.md
new file mode 100644
index 000000000..8b87664cb
--- /dev/null
+++ b/docs/en/docs/reference/fastapi.md
@@ -0,0 +1,32 @@
+# `FastAPI` class
+
+Here's the reference information for the `FastAPI` class, with all its parameters,
+attributes and methods.
+
+You can import the `FastAPI` class directly from `fastapi`:
+
+```python
+from fastapi import FastAPI
+```
+
+::: fastapi.FastAPI
+    options:
+        members:
+            - openapi_version
+            - webhooks
+            - state
+            - dependency_overrides
+            - openapi
+            - websocket
+            - include_router
+            - get
+            - put
+            - post
+            - delete
+            - options
+            - head
+            - patch
+            - trace
+            - on_event
+            - middleware
+            - exception_handler
diff --git a/docs/en/docs/reference/httpconnection.md b/docs/en/docs/reference/httpconnection.md
new file mode 100644
index 000000000..43dfc46f9
--- /dev/null
+++ b/docs/en/docs/reference/httpconnection.md
@@ -0,0 +1,13 @@
+# `HTTPConnection` class
+
+When you want to define dependencies that should be compatible with both HTTP and
+WebSockets, you can define a parameter that takes an `HTTPConnection` instead of a
+`Request` or a `WebSocket`.
+
+You can import it from `fastapi.requests`:
+
+```python
+from fastapi.requests import HTTPConnection
+```
+
+::: fastapi.requests.HTTPConnection
diff --git a/docs/en/docs/reference/index.md b/docs/en/docs/reference/index.md
new file mode 100644
index 000000000..512d5c25c
--- /dev/null
+++ b/docs/en/docs/reference/index.md
@@ -0,0 +1,7 @@
+# Reference - Code API
+
+Here's the reference or code API, the classes, functions, parameters, attributes, and
+all the FastAPI parts you can use in your applications.
+
+If you want to **learn FastAPI** you are much better off reading the
+[FastAPI Tutorial](https://fastapi.tiangolo.com/tutorial/).
diff --git a/docs/en/docs/reference/middleware.md b/docs/en/docs/reference/middleware.md
new file mode 100644
index 000000000..89704d3c8
--- /dev/null
+++ b/docs/en/docs/reference/middleware.md
@@ -0,0 +1,46 @@
+# Middleware
+
+There are several middlewares available provided by Starlette directly.
+
+Read more about them in the
+[FastAPI docs for Middleware](https://fastapi.tiangolo.com/advanced/middleware/).
+
+::: fastapi.middleware.cors.CORSMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.cors import CORSMiddleware
+```
+
+::: fastapi.middleware.gzip.GZipMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.gzip import GZipMiddleware
+```
+
+::: fastapi.middleware.httpsredirect.HTTPSRedirectMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.httpsredirect import HTTPSRedirectMiddleware
+```
+
+::: fastapi.middleware.trustedhost.TrustedHostMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.trustedhost import TrustedHostMiddleware
+```
+
+::: fastapi.middleware.wsgi.WSGIMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.wsgi import WSGIMiddleware
+```
diff --git a/docs/en/docs/reference/openapi/docs.md b/docs/en/docs/reference/openapi/docs.md
new file mode 100644
index 000000000..ab620833e
--- /dev/null
+++ b/docs/en/docs/reference/openapi/docs.md
@@ -0,0 +1,11 @@
+# OpenAPI `docs`
+
+Utilities to handle OpenAPI automatic UI documentation, including Swagger UI (by default at `/docs`) and ReDoc (by default at `/redoc`).
+
+::: fastapi.openapi.docs.get_swagger_ui_html
+
+::: fastapi.openapi.docs.get_redoc_html
+
+::: fastapi.openapi.docs.get_swagger_ui_oauth2_redirect_html
+
+::: fastapi.openapi.docs.swagger_ui_default_parameters
diff --git a/docs/en/docs/reference/openapi/index.md b/docs/en/docs/reference/openapi/index.md
new file mode 100644
index 000000000..e2b313f15
--- /dev/null
+++ b/docs/en/docs/reference/openapi/index.md
@@ -0,0 +1,5 @@
+# OpenAPI
+
+There are several utilities to handle OpenAPI.
+
+You normally don't need to use them unless you have a specific advanced use case that requires it.
diff --git a/docs/en/docs/reference/openapi/models.md b/docs/en/docs/reference/openapi/models.md
new file mode 100644
index 000000000..4a6b0770e
--- /dev/null
+++ b/docs/en/docs/reference/openapi/models.md
@@ -0,0 +1,5 @@
+# OpenAPI `models`
+
+OpenAPI Pydantic models used to generate and validate the generated OpenAPI.
+
+::: fastapi.openapi.models
diff --git a/docs/en/docs/reference/parameters.md b/docs/en/docs/reference/parameters.md
new file mode 100644
index 000000000..8f77f0161
--- /dev/null
+++ b/docs/en/docs/reference/parameters.md
@@ -0,0 +1,36 @@
+# Request Parameters
+
+Here's the reference information for the request parameters.
+
+These are the special functions that you can put in *path operation function*
+parameters or dependency functions with `Annotated` to get data from the request.
+
+It includes:
+
+* `Query()`
+* `Path()`
+* `Body()`
+* `Cookie()`
+* `Header()`
+* `Form()`
+* `File()`
+
+You can import them all directly from `fastapi`:
+
+```python
+from fastapi import Body, Cookie, File, Form, Header, Path, Query
+```
+
+::: fastapi.Query
+
+::: fastapi.Path
+
+::: fastapi.Body
+
+::: fastapi.Cookie
+
+::: fastapi.Header
+
+::: fastapi.Form
+
+::: fastapi.File
diff --git a/docs/en/docs/reference/request.md b/docs/en/docs/reference/request.md
new file mode 100644
index 000000000..91ec7d37b
--- /dev/null
+++ b/docs/en/docs/reference/request.md
@@ -0,0 +1,18 @@
+# `Request` class
+
+You can declare a parameter in a *path operation function* or dependency to be of type
+`Request` and then you can access the raw request object directly, without any
+validation, etc.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import Request
+```
+
+!!! tip
+    When you want to define dependencies that should be compatible with both HTTP and
+    WebSockets, you can define a parameter that takes an `HTTPConnection` instead of a
+    `Request` or a `WebSocket`.
+
+::: fastapi.Request
diff --git a/docs/en/docs/reference/response.md b/docs/en/docs/reference/response.md
new file mode 100644
index 000000000..916254583
--- /dev/null
+++ b/docs/en/docs/reference/response.md
@@ -0,0 +1,15 @@
+# `Response` class
+
+You can declare a parameter in a *path operation function* or dependency to be of type
+`Response` and then you can set data for the response like headers or cookies.
+
+You can also use it directly to create an instance of it and return it from your *path
+operations*.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import Response
+```
+
+::: fastapi.Response
diff --git a/docs/en/docs/reference/responses.md b/docs/en/docs/reference/responses.md
new file mode 100644
index 000000000..2cbbd8963
--- /dev/null
+++ b/docs/en/docs/reference/responses.md
@@ -0,0 +1,166 @@
+# Custom Response Classes - File, HTML, Redirect, Streaming, etc.
+
+There are several custom response classes you can use to create an instance and return
+them directly from your *path operations*.
+
+Read more about it in the
+[FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/).
+
+You can import them directly from `fastapi.responses`:
+
+```python
+from fastapi.responses import (
+    FileResponse,
+    HTMLResponse,
+    JSONResponse,
+    ORJSONResponse,
+    PlainTextResponse,
+    RedirectResponse,
+    Response,
+    StreamingResponse,
+    UJSONResponse,
+)
+```
+
+## FastAPI Responses
+
+There are a couple of custom FastAPI response classes, you can use them to optimize JSON performance.
+
+::: fastapi.responses.UJSONResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.ORJSONResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+## Starlette Responses
+
+::: fastapi.responses.FileResponse
+    options:
+        members:
+            - chunk_size
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.HTMLResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.JSONResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.PlainTextResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.RedirectResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.Response
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.StreamingResponse
+    options:
+        members:
+            - body_iterator
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
diff --git a/docs/en/docs/reference/security/index.md b/docs/en/docs/reference/security/index.md
new file mode 100644
index 000000000..ff86e9e30
--- /dev/null
+++ b/docs/en/docs/reference/security/index.md
@@ -0,0 +1,76 @@
+# Security Tools
+
+When you need to declare dependencies with OAuth2 scopes you use `Security()`.
+
+But you still need to define what is the dependable, the callable that you pass as
+a parameter to `Depends()` or `Security()`.
+
+There are multiple tools that you can use to create those dependables, and they get
+integrated into OpenAPI so they are shown in the automatic docs UI, they can be used
+by automatically generated clients and SDKs, etc.
+
+You can import them from `fastapi.security`:
+
+```python
+from fastapi.security import (
+    APIKeyCookie,
+    APIKeyHeader,
+    APIKeyQuery,
+    HTTPAuthorizationCredentials,
+    HTTPBasic,
+    HTTPBasicCredentials,
+    HTTPBearer,
+    HTTPDigest,
+    OAuth2,
+    OAuth2AuthorizationCodeBearer,
+    OAuth2PasswordBearer,
+    OAuth2PasswordRequestForm,
+    OAuth2PasswordRequestFormStrict,
+    OpenIdConnect,
+    SecurityScopes,
+)
+```
+
+## API Key Security Schemes
+
+::: fastapi.security.APIKeyCookie
+
+::: fastapi.security.APIKeyHeader
+
+::: fastapi.security.APIKeyQuery
+
+## HTTP Authentication Schemes
+
+::: fastapi.security.HTTPBasic
+
+::: fastapi.security.HTTPBearer
+
+::: fastapi.security.HTTPDigest
+
+## HTTP Credentials
+
+::: fastapi.security.HTTPAuthorizationCredentials
+
+::: fastapi.security.HTTPBasicCredentials
+
+## OAuth2 Authentication
+
+::: fastapi.security.OAuth2
+
+::: fastapi.security.OAuth2AuthorizationCodeBearer
+
+::: fastapi.security.OAuth2PasswordBearer
+
+## OAuth2 Password Form
+
+::: fastapi.security.OAuth2PasswordRequestForm
+
+::: fastapi.security.OAuth2PasswordRequestFormStrict
+
+## OAuth2 Security Scopes in Dependencies
+
+::: fastapi.security.SecurityScopes
+
+## OpenID Connect
+
+::: fastapi.security.OpenIdConnect
diff --git a/docs/en/docs/reference/staticfiles.md b/docs/en/docs/reference/staticfiles.md
new file mode 100644
index 000000000..ce66f17b3
--- /dev/null
+++ b/docs/en/docs/reference/staticfiles.md
@@ -0,0 +1,14 @@
+# Static Files - `StaticFiles`
+
+You can use the `StaticFiles` class to serve static files, like JavaScript, CSS, images, etc.
+
+Read more about it in the
+[FastAPI docs for Static Files](https://fastapi.tiangolo.com/tutorial/static-files/).
+
+You can import it directly from `fastapi.staticfiles`:
+
+```python
+from fastapi.staticfiles import StaticFiles
+```
+
+::: fastapi.staticfiles.StaticFiles
diff --git a/docs/en/docs/reference/status.md b/docs/en/docs/reference/status.md
new file mode 100644
index 000000000..54fba9387
--- /dev/null
+++ b/docs/en/docs/reference/status.md
@@ -0,0 +1,39 @@
+# Status Codes
+
+You can import the `status` module from `fastapi`:
+
+```python
+from fastapi import status
+```
+
+`status` is provided directly by Starlette.
+
+It containes a group of named constants (variables) with integer status codes.
+
+For example:
+
+* 200: `status.HTTP_200_OK`
+* 403: `status.HTTP_403_FORBIDDEN`
+* etc.
+
+It can be convenient to quickly access HTTP (and WebSocket) status codes in your app,
+using autocompletion for the name without having to remember the integer status codes
+by memory.
+
+Read more about it in the
+[FastAPI docs about Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+
+## Example
+
+```python
+from fastapi import FastAPI, status
+
+app = FastAPI()
+
+
+@app.get("/items/", status_code=status.HTTP_418_IM_A_TEAPOT)
+def read_items():
+    return [{"name": "Plumbus"}, {"name": "Portal Gun"}]
+```
+
+::: fastapi.status
diff --git a/docs/en/docs/reference/templating.md b/docs/en/docs/reference/templating.md
new file mode 100644
index 000000000..c865badfc
--- /dev/null
+++ b/docs/en/docs/reference/templating.md
@@ -0,0 +1,14 @@
+# Templating - `Jinja2Templates`
+
+You can use the `Jinja2Templates` class to render Jinja templates.
+
+Read more about it in the
+[FastAPI docs for Templates](https://fastapi.tiangolo.com/advanced/templates/).
+
+You can import it directly from `fastapi.templating`:
+
+```python
+from fastapi.templating import Jinja2Templates
+```
+
+::: fastapi.templating.Jinja2Templates
diff --git a/docs/en/docs/reference/testclient.md b/docs/en/docs/reference/testclient.md
new file mode 100644
index 000000000..e391d964a
--- /dev/null
+++ b/docs/en/docs/reference/testclient.md
@@ -0,0 +1,14 @@
+# Test Client - `TestClient`
+
+You can use the `TestClient` class to test FastAPI applications without creating an actual HTTP and socket connection, just communicating directly with the FastAPI code.
+
+Read more about it in the
+[FastAPI docs for Testing](https://fastapi.tiangolo.com/tutorial/testing/).
+
+You can import it directly from `fastapi.testclient`:
+
+```python
+from fastapi.testclient import TestClient
+```
+
+::: fastapi.testclient.TestClient
diff --git a/docs/en/docs/reference/uploadfile.md b/docs/en/docs/reference/uploadfile.md
new file mode 100644
index 000000000..45c644b18
--- /dev/null
+++ b/docs/en/docs/reference/uploadfile.md
@@ -0,0 +1,23 @@
+# `UploadFile` class
+
+You can define *path operation function* parameters to be of the type `UploadFile`
+to receive files from the request.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import UploadFile
+```
+
+::: fastapi.UploadFile
+    options:
+        members:
+            - file
+            - filename
+            - size
+            - headers
+            - content_type
+            - read
+            - write
+            - seek
+            - close
diff --git a/docs/en/docs/reference/websockets.md b/docs/en/docs/reference/websockets.md
new file mode 100644
index 000000000..2a0469467
--- /dev/null
+++ b/docs/en/docs/reference/websockets.md
@@ -0,0 +1,70 @@
+# WebSockets
+
+When defining WebSockets, you normally declare a parameter of type `WebSocket` and
+with it you can read data from the client and send data to it.
+
+It is provided directly by Starlette, but you can import it from `fastapi`:
+
+```python
+from fastapi import WebSocket
+```
+
+!!! tip
+    When you want to define dependencies that should be compatible with both HTTP and
+    WebSockets, you can define a parameter that takes an `HTTPConnection` instead of a
+    `Request` or a `WebSocket`.
+
+::: fastapi.WebSocket
+    options:
+        members:
+            - scope
+            - app
+            - url
+            - base_url
+            - headers
+            - query_params
+            - path_params
+            - cookies
+            - client
+            - state
+            - url_for
+            - client_state
+            - application_state
+            - receive
+            - send
+            - accept
+            - receive_text
+            - receive_bytes
+            - receive_json
+            - iter_text
+            - iter_bytes
+            - iter_json
+            - send_text
+            - send_bytes
+            - send_json
+            - close
+
+When a client disconnects, a `WebSocketDisconnect` exception is raised, you can catch
+it.
+
+You can import it directly form `fastapi`:
+
+```python
+from fastapi import WebSocketDisconnect
+```
+
+::: fastapi.WebSocketDisconnect
+
+## WebSockets - additional classes
+
+Additional classes for handling WebSockets.
+
+Provided directly by Starlette, but you can import it from `fastapi`:
+
+```python
+from fastapi.websockets import WebSocketDisconnect, WebSocketState
+```
+
+::: fastapi.websockets.WebSocketDisconnect
+
+::: fastapi.websockets.WebSocketState
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 72fa346d1..b62656982 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -1,12 +1,270 @@
+---
+hide:
+  - navigation
+---
+
 # Release Notes
 
 ## Latest Changes
 
+### Internal
+
+* 📝 Update release notes, move and check latest-changes. PR [#10588](https://github.com/tiangolo/fastapi/pull/10588) by [@tiangolo](https://github.com/tiangolo).
+* 👷 Upgrade latest-changes GitHub Action. PR [#10587](https://github.com/tiangolo/fastapi/pull/10587) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.104.1
+
+### Fixes
+
+* 📌 Pin Swagger UI version to 5.9.0 temporarily to handle a bug crashing it in 5.9.1. PR [#10529](https://github.com/tiangolo/fastapi/pull/10529) by [@alejandraklachquin](https://github.com/alejandraklachquin).
+    * This is not really a bug in FastAPI but in Swagger UI, nevertheless pinning the version will work while a solution is found on the [Swagger UI side](https://github.com/swagger-api/swagger-ui/issues/9337).
+
+### Docs
+
+* 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).
+* ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).
+* 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).
+* ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).
+* ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).
+* ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).
+* 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).
+* ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).
+* 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
+* ✏️ Update Pydantic links to dotenv support. PR [#10511](https://github.com/tiangolo/fastapi/pull/10511) by [@White-Mask](https://github.com/White-Mask).
+* ✏️ Update links in `docs/en/docs/async.md` and `docs/zh/docs/async.md` to make them relative. PR [#10498](https://github.com/tiangolo/fastapi/pull/10498) by [@hasnatsajid](https://github.com/hasnatsajid).
+* ✏️ Fix links in `docs/em/docs/async.md`. PR [#10507](https://github.com/tiangolo/fastapi/pull/10507) by [@hasnatsajid](https://github.com/hasnatsajid).
+* ✏️ Fix typo in `docs/em/docs/index.md`, Python 3.8. PR [#10521](https://github.com/tiangolo/fastapi/pull/10521) by [@kerriop](https://github.com/kerriop).
+* ⬆ Bump pillow from 9.5.0 to 10.1.0. PR [#10446](https://github.com/tiangolo/fastapi/pull/10446) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* ⬆ Update mkdocs-material requirement from <9.0.0,>=8.1.4 to >=8.1.4,<10.0.0. PR [#5862](https://github.com/tiangolo/fastapi/pull/5862) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* ⬆ Bump mkdocs-material from 9.1.21 to 9.4.7. PR [#10545](https://github.com/tiangolo/fastapi/pull/10545) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* 👷 Install MkDocs Material Insiders only when secrets are available, for Dependabot. PR [#10544](https://github.com/tiangolo/fastapi/pull/10544) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsors badges, Databento. PR [#10519](https://github.com/tiangolo/fastapi/pull/10519) by [@tiangolo](https://github.com/tiangolo).
+* 👷 Adopt Ruff format. PR [#10517](https://github.com/tiangolo/fastapi/pull/10517) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Add `CITATION.cff` file for academic citations. PR [#10496](https://github.com/tiangolo/fastapi/pull/10496) by [@tiangolo](https://github.com/tiangolo).
+* 🐛 Fix overriding MKDocs theme lang in hook. PR [#10490](https://github.com/tiangolo/fastapi/pull/10490) by [@tiangolo](https://github.com/tiangolo).
+* 🔥 Drop/close Gitter chat. Questions should go to GitHub Discussions, free conversations to Discord.. PR [#10485](https://github.com/tiangolo/fastapi/pull/10485) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.104.0
+
+## Features
+
+* ✨ Add reference (code API) docs with PEP 727, add subclass with custom docstrings for `BackgroundTasks`, refactor docs structure. PR [#10392](https://github.com/tiangolo/fastapi/pull/10392) by [@tiangolo](https://github.com/tiangolo). New docs at [FastAPI Reference - Code API](https://fastapi.tiangolo.com/reference/).
+
+## Upgrades
+
+* ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
+* ⬆ Bump dawidd6/action-download-artifact from 2.27.0 to 2.28.0. PR [#10268](https://github.com/tiangolo/fastapi/pull/10268) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* ⬆ Bump actions/checkout from 3 to 4. PR [#10208](https://github.com/tiangolo/fastapi/pull/10208) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.10. PR [#10061](https://github.com/tiangolo/fastapi/pull/10061) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* 🔧 Update sponsors, Bump.sh images. PR [#10381](https://github.com/tiangolo/fastapi/pull/10381) by [@tiangolo](https://github.com/tiangolo).
+* 👥 Update FastAPI People. PR [#10363](https://github.com/tiangolo/fastapi/pull/10363) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.103.2
+
+### Refactors
+
+* ⬆️ Upgrade compatibility with Pydantic v2.4, new renamed functions and JSON Schema input/output models with default values. PR [#10344](https://github.com/tiangolo/fastapi/pull/10344) by [@tiangolo](https://github.com/tiangolo).
+
+### Translations
+
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/extra-data-types.md`. PR [#10132](https://github.com/tiangolo/fastapi/pull/10132) by [@ArtemKhymenko](https://github.com/ArtemKhymenko).
+* 🌐 Fix typos in French translations for `docs/fr/docs/advanced/path-operation-advanced-configuration.md`, `docs/fr/docs/alternatives.md`, `docs/fr/docs/async.md`, `docs/fr/docs/features.md`, `docs/fr/docs/help-fastapi.md`, `docs/fr/docs/index.md`, `docs/fr/docs/python-types.md`, `docs/fr/docs/tutorial/body.md`, `docs/fr/docs/tutorial/first-steps.md`, `docs/fr/docs/tutorial/query-params.md`. PR [#10154](https://github.com/tiangolo/fastapi/pull/10154) by [@s-rigaud](https://github.com/s-rigaud).
+* 🌐 Add Chinese translation for `docs/zh/docs/async.md`. PR [#5591](https://github.com/tiangolo/fastapi/pull/5591) by [@mkdir700](https://github.com/mkdir700).
+* 🌐 Update Chinese translation for `docs/tutorial/security/simple-oauth2.md`. PR [#3844](https://github.com/tiangolo/fastapi/pull/3844) by [@jaystone776](https://github.com/jaystone776).
+* 🌐 Add Korean translation for `docs/ko/docs/deployment/cloud.md`. PR [#10191](https://github.com/tiangolo/fastapi/pull/10191) by [@Sion99](https://github.com/Sion99).
+* 🌐 Add Japanese translation for `docs/ja/docs/deployment/https.md`. PR [#10298](https://github.com/tiangolo/fastapi/pull/10298) by [@tamtam-fitness](https://github.com/tamtam-fitness).
+* 🌐 Fix typo in Russian translation for `docs/ru/docs/tutorial/body-fields.md`. PR [#10224](https://github.com/tiangolo/fastapi/pull/10224) by [@AlertRED](https://github.com/AlertRED).
+* 🌐 Add Polish translation for `docs/pl/docs/help-fastapi.md`. PR [#10121](https://github.com/tiangolo/fastapi/pull/10121) by [@romabozhanovgithub](https://github.com/romabozhanovgithub).
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/header-params.md`. PR [#10226](https://github.com/tiangolo/fastapi/pull/10226) by [@AlertRED](https://github.com/AlertRED).
+* 🌐 Add Chinese translation for `docs/zh/docs/deployment/versions.md`. PR [#10276](https://github.com/tiangolo/fastapi/pull/10276) by [@xzmeng](https://github.com/xzmeng).
+
+### Internal
+
+* 🔧 Update sponsors, remove Flint. PR [#10349](https://github.com/tiangolo/fastapi/pull/10349) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Rename label "awaiting review" to "awaiting-review" to simplify search queries. PR [#10343](https://github.com/tiangolo/fastapi/pull/10343) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsors, enable Svix (revert #10228). PR [#10253](https://github.com/tiangolo/fastapi/pull/10253) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsors, remove Svix. PR [#10228](https://github.com/tiangolo/fastapi/pull/10228) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsors, add Bump.sh. PR [#10227](https://github.com/tiangolo/fastapi/pull/10227) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.103.1
+
+### Fixes
+
+* 📌 Pin AnyIO to < 4.0.0 to handle an incompatibility while upgrading to Starlette 0.31.1. PR [#10194](https://github.com/tiangolo/fastapi/pull/10194) by [@tiangolo](https://github.com/tiangolo).
+
+### Docs
+
+* ✏️ Fix validation parameter name in docs, from `regex` to `pattern`. PR [#10085](https://github.com/tiangolo/fastapi/pull/10085) by [@pablodorrio](https://github.com/pablodorrio).
+* ✏️ Fix indent format in `docs/en/docs/deployment/server-workers.md`. PR [#10066](https://github.com/tiangolo/fastapi/pull/10066) by [@tamtam-fitness](https://github.com/tamtam-fitness).
+* ✏️ Fix Pydantic examples in tutorial for Python types. PR [#9961](https://github.com/tiangolo/fastapi/pull/9961) by [@rahulsalgare](https://github.com/rahulsalgare).
+* ✏️ Fix link to Pydantic docs in `docs/en/docs/tutorial/extra-data-types.md`. PR [#10155](https://github.com/tiangolo/fastapi/pull/10155) by [@hasnatsajid](https://github.com/hasnatsajid).
+* ✏️ Fix typo in `docs/en/docs/tutorial/handling-errors.md`. PR [#10170](https://github.com/tiangolo/fastapi/pull/10170) by [@poupapaa](https://github.com/poupapaa).
+* ✏️ Fix typo in `docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#10172](https://github.com/tiangolo/fastapi/pull/10172) by [@ragul-kachiappan](https://github.com/ragul-kachiappan).
+
+### Translations
+
+* 🌐 Remove duplicate line in translation for `docs/pt/docs/tutorial/path-params.md`. PR [#10126](https://github.com/tiangolo/fastapi/pull/10126) by [@LecoOliveira](https://github.com/LecoOliveira).
+* 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).
+* 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/alternatives.md`. PR [#10060](https://github.com/tiangolo/fastapi/pull/10060) by [@whysage](https://github.com/whysage).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/index.md`. PR [#10079](https://github.com/tiangolo/fastapi/pull/10079) by [@rostik1410](https://github.com/rostik1410).
+* ✏️ Fix typos in `docs/en/docs/how-to/separate-openapi-schemas.md` and `docs/en/docs/tutorial/schema-extra-example.md`. PR [#10189](https://github.com/tiangolo/fastapi/pull/10189) by [@xzmeng](https://github.com/xzmeng).
+* 🌐 Add Chinese translation for `docs/zh/docs/advanced/generate-clients.md`. PR [#9883](https://github.com/tiangolo/fastapi/pull/9883) by [@funny-cat-happy](https://github.com/funny-cat-happy).
+
+### Refactors
+
+* ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).
+* ✅ Add missing test for OpenAPI examples, it was missing in coverage. PR [#10188](https://github.com/tiangolo/fastapi/pull/10188) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
+* 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.103.0
+
+### Features
+
+* ✨ Add support for `openapi_examples` in all FastAPI parameters. PR [#10152](https://github.com/tiangolo/fastapi/pull/10152) by [@tiangolo](https://github.com/tiangolo).
+    * New docs: [OpenAPI-specific examples](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#openapi-specific-examples).
+
+### Docs
+
+* 📝 Add note to docs about Separate Input and Output Schemas with FastAPI version. PR [#10150](https://github.com/tiangolo/fastapi/pull/10150) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.102.0
+
+### Features
+
+* ✨ Add support for disabling the separation of input and output JSON Schemas in OpenAPI with Pydantic v2 with `separate_input_output_schemas=False`. PR [#10145](https://github.com/tiangolo/fastapi/pull/10145) by [@tiangolo](https://github.com/tiangolo).
+    * New docs [Separate OpenAPI Schemas for Input and Output or Not](https://fastapi.tiangolo.com/how-to/separate-openapi-schemas/).
+    * This PR also includes a new setup (internal tools) for generating screenshots for the docs.
+
+### Refactors
+
+* ♻️ Refactor tests for new Pydantic 2.2.1. PR [#10115](https://github.com/tiangolo/fastapi/pull/10115) by [@tiangolo](https://github.com/tiangolo).
+
+### Docs
+
+* 📝 Add new docs section, How To - Recipes, move docs that don't have to be read by everyone to How To. PR [#10114](https://github.com/tiangolo/fastapi/pull/10114) by [@tiangolo](https://github.com/tiangolo).
+* 📝 Update Advanced docs, add links to sponsor courses. PR [#10113](https://github.com/tiangolo/fastapi/pull/10113) by [@tiangolo](https://github.com/tiangolo).
+* 📝 Update docs for generating clients. PR [#10112](https://github.com/tiangolo/fastapi/pull/10112) by [@tiangolo](https://github.com/tiangolo).
+* 📝 Tweak MkDocs and add redirects. PR [#10111](https://github.com/tiangolo/fastapi/pull/10111) by [@tiangolo](https://github.com/tiangolo).
+* 📝 Restructure docs for cloud providers, include links to sponsors. PR [#10110](https://github.com/tiangolo/fastapi/pull/10110) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
+* 🔧 Update sponsors, add Speakeasy. PR [#10098](https://github.com/tiangolo/fastapi/pull/10098) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.101.1
+
+### Fixes
+
+* ✨ Add `ResponseValidationError` printable details, to show up in server error logs. PR [#10078](https://github.com/tiangolo/fastapi/pull/10078) by [@tiangolo](https://github.com/tiangolo).
+
+### Refactors
+
+* ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).
+* ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).
+
+### Docs
+
+* ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).
+* 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).
+* 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).
+* 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).
+
+### Translations
+
+* 🌐 Add Japanese translation for `docs/ja/docs/deployment/concepts.md`. PR [#10062](https://github.com/tiangolo/fastapi/pull/10062) by [@tamtam-fitness](https://github.com/tamtam-fitness).
+* 🌐 Add Japanese translation for `docs/ja/docs/deployment/server-workers.md`. PR [#10064](https://github.com/tiangolo/fastapi/pull/10064) by [@tamtam-fitness](https://github.com/tamtam-fitness).
+* 🌐 Update Japanese translation for `docs/ja/docs/deployment/docker.md`. PR [#10073](https://github.com/tiangolo/fastapi/pull/10073) by [@tamtam-fitness](https://github.com/tamtam-fitness).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/fastapi-people.md`. PR [#10059](https://github.com/tiangolo/fastapi/pull/10059) by [@rostik1410](https://github.com/rostik1410).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-params.md`. PR [#10032](https://github.com/tiangolo/fastapi/pull/10032) by [@rostik1410](https://github.com/rostik1410).
+* 🌐 Add Russian translation for `docs/ru/docs/deployment/docker.md`. PR [#9971](https://github.com/tiangolo/fastapi/pull/9971) by [@Xewus](https://github.com/Xewus).
+* 🌐 Add Vietnamese translation for `docs/vi/docs/python-types.md`. PR [#10047](https://github.com/tiangolo/fastapi/pull/10047) by [@magiskboy](https://github.com/magiskboy).
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/dependencies/global-dependencies.md`. PR [#9970](https://github.com/tiangolo/fastapi/pull/9970) by [@dudyaosuplayer](https://github.com/dudyaosuplayer).
+* 🌐 Add Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#9974](https://github.com/tiangolo/fastapi/pull/9974) by [@AhsanSheraz](https://github.com/AhsanSheraz).
+
+### Internal
+
+* 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).
+* ⬆ Bump mypy from 1.4.0 to 1.4.1. PR [#9756](https://github.com/tiangolo/fastapi/pull/9756) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* ⬆ Bump mkdocs-material from 9.1.17 to 9.1.21. PR [#9960](https://github.com/tiangolo/fastapi/pull/9960) by [@dependabot[bot]](https://github.com/apps/dependabot).
+
+## 0.101.0
+
+### Features
+
+* ✨ Enable Pydantic's serialization mode for responses, add support for Pydantic's `computed_field`, better OpenAPI for response models, proper required attributes, better generated clients. PR [#10011](https://github.com/tiangolo/fastapi/pull/10011) by [@tiangolo](https://github.com/tiangolo).
+
+### Refactors
+
+* ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
+* ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
+
+### Upgrades
+
+* 📌 Do not allow Pydantic 2.1.0 that breaks (require 2.1.1). PR [#10012](https://github.com/tiangolo/fastapi/pull/10012) by [@tiangolo](https://github.com/tiangolo).
+
+### Translations
+
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).
+* 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
+* 👷 Add GitHub Actions step dump context to debug external failures. PR [#10008](https://github.com/tiangolo/fastapi/pull/10008) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Restore MkDocs Material pin after the fix. PR [#10001](https://github.com/tiangolo/fastapi/pull/10001) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update the Question template to ask for the Pydantic version. PR [#10000](https://github.com/tiangolo/fastapi/pull/10000) by [@tiangolo](https://github.com/tiangolo).
+* 📍 Update MkDocs Material dependencies. PR [#9986](https://github.com/tiangolo/fastapi/pull/9986) by [@tiangolo](https://github.com/tiangolo).
+* 👥 Update FastAPI People. PR [#9999](https://github.com/tiangolo/fastapi/pull/9999) by [@tiangolo](https://github.com/tiangolo).
+* 🐳 Update Dockerfile with compatibility versions, to upgrade later. PR [#9998](https://github.com/tiangolo/fastapi/pull/9998) by [@tiangolo](https://github.com/tiangolo).
+* ➕ Add pydantic-settings to FastAPI People dependencies. PR [#9988](https://github.com/tiangolo/fastapi/pull/9988) by [@tiangolo](https://github.com/tiangolo).
+* ♻️ Update FastAPI People logic with new Pydantic. PR [#9985](https://github.com/tiangolo/fastapi/pull/9985) by [@tiangolo](https://github.com/tiangolo).
+* 🍱 Update sponsors, Fern badge. PR [#9982](https://github.com/tiangolo/fastapi/pull/9982) by [@tiangolo](https://github.com/tiangolo).
+* 👷 Deploy docs to Cloudflare Pages. PR [#9978](https://github.com/tiangolo/fastapi/pull/9978) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsor Fern. PR [#9979](https://github.com/tiangolo/fastapi/pull/9979) by [@tiangolo](https://github.com/tiangolo).
+* 👷 Update CI debug mode with Tmate. PR [#9977](https://github.com/tiangolo/fastapi/pull/9977) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.100.1
+
+### Fixes
+
+* 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
+
+### Docs
+
+* 📝 Update links for self-hosted Swagger UI, point to v5, for OpenAPI 31.0. PR [#9834](https://github.com/tiangolo/fastapi/pull/9834) by [@tiangolo](https://github.com/tiangolo).
+
+### Translations
+
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/body.md`. PR [#4574](https://github.com/tiangolo/fastapi/pull/4574) by [@ss-o-furda](https://github.com/ss-o-furda).
+* 🌐 Add Vietnamese translation for `docs/vi/docs/features.md` and `docs/vi/docs/index.md`. PR [#3006](https://github.com/tiangolo/fastapi/pull/3006) by [@magiskboy](https://github.com/magiskboy).
+* 🌐 Add Korean translation for `docs/ko/docs/async.md`. PR [#4179](https://github.com/tiangolo/fastapi/pull/4179) by [@NinaHwang](https://github.com/NinaHwang).
+* 🌐 Add Chinese translation for `docs/zh/docs/tutorial/background-tasks.md`. PR [#9812](https://github.com/tiangolo/fastapi/pull/9812) by [@wdh99](https://github.com/wdh99).
+* 🌐 Add French translation for `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#4075](https://github.com/tiangolo/fastapi/pull/4075) by [@Smlep](https://github.com/Smlep).
+* 🌐 Add French translation for `docs/fr/docs/tutorial/index.md`. PR [#2234](https://github.com/tiangolo/fastapi/pull/2234) by [@JulianMaurin](https://github.com/JulianMaurin).
+* 🌐 Add French translation for `docs/fr/docs/contributing.md`. PR [#2132](https://github.com/tiangolo/fastapi/pull/2132) by [@JulianMaurin](https://github.com/JulianMaurin).
+* 🌐 Add French translation for `docs/fr/docs/benchmarks.md`. PR [#2155](https://github.com/tiangolo/fastapi/pull/2155) by [@clemsau](https://github.com/clemsau).
+* 🌐 Update Chinese translations with new source files. PR [#9738](https://github.com/tiangolo/fastapi/pull/9738) by [@mahone3297](https://github.com/mahone3297).
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/request-forms.md`. PR [#9841](https://github.com/tiangolo/fastapi/pull/9841) by [@dedkot01](https://github.com/dedkot01).
+* 🌐 Update Chinese translation for `docs/zh/docs/tutorial/handling-errors.md`. PR [#9485](https://github.com/tiangolo/fastapi/pull/9485) by [@Creat55](https://github.com/Creat55).
+
+### Internal
+
+* 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update FastAPI People token. PR [#9844](https://github.com/tiangolo/fastapi/pull/9844) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9775](https://github.com/tiangolo/fastapi/pull/9775) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update MkDocs Material token. PR [#9843](https://github.com/tiangolo/fastapi/pull/9843) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update token for latest changes. PR [#9842](https://github.com/tiangolo/fastapi/pull/9842) by [@tiangolo](https://github.com/tiangolo).
-* 📝 Update links for self-hosted Swagger UI, point to v5, for OpenAPI 31.0. PR [#9834](https://github.com/tiangolo/fastapi/pull/9834) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.100.0
 
@@ -38,7 +296,7 @@ A command line tool that will **process your code** and update most of the thing
 
 ### Pydantic v1
 
-**This version of FastAPI still supports Pydantic v1**. And although Pydantic v1 will be deprecated at some point, ti will still be supported for a while.
+**This version of FastAPI still supports Pydantic v1**. And although Pydantic v1 will be deprecated at some point, it will still be supported for a while.
 
 This means that you can install the new Pydantic v2, and if something fails, you can install Pydantic v1 while you fix any problems you might have, but having the latest FastAPI.
 
diff --git a/docs/en/docs/resources/index.md b/docs/en/docs/resources/index.md
new file mode 100644
index 000000000..8c7cac43b
--- /dev/null
+++ b/docs/en/docs/resources/index.md
@@ -0,0 +1,3 @@
+# Resources
+
+Additional resources, external links, articles and more. ✈️
diff --git a/docs/en/docs/tutorial/background-tasks.md b/docs/en/docs/tutorial/background-tasks.md
index 178297192..bc8e2af6a 100644
--- a/docs/en/docs/tutorial/background-tasks.md
+++ b/docs/en/docs/tutorial/background-tasks.md
@@ -69,7 +69,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
     {!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14  16  23  26"
     {!> ../../../docs_src/background_tasks/tutorial002_an.py!}
@@ -84,7 +84,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
     {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index daa7353a2..1cf7e50e0 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -118,13 +118,13 @@ We will now use a simple dependency to read a custom `X-Token` header:
     {!> ../../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  5-7"
     {!> ../../../docs_src/bigger_applications/app_an/dependencies.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -377,7 +377,7 @@ The `router` from `users` would overwrite the one from `items` and we wouldn't b
 
 So, to be able to use both of them in the same file, we import the submodules directly:
 
-```Python hl_lines="4"
+```Python hl_lines="5"
 {!../../../docs_src/bigger_applications/app/main.py!}
 ```
 
diff --git a/docs/en/docs/tutorial/body-fields.md b/docs/en/docs/tutorial/body-fields.md
index 8966032ff..55e67fdd6 100644
--- a/docs/en/docs/tutorial/body-fields.md
+++ b/docs/en/docs/tutorial/body-fields.md
@@ -18,7 +18,7 @@ First, you have to import it:
     {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body_fields/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First, you have to import it:
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -61,7 +61,7 @@ You can then use `Field` with model attributes:
     {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12-15"
     {!> ../../../docs_src/body_fields/tutorial001_an.py!}
@@ -76,7 +76,7 @@ You can then use `Field` with model attributes:
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/body-multiple-params.md b/docs/en/docs/tutorial/body-multiple-params.md
index b214092c9..ebef8eeaa 100644
--- a/docs/en/docs/tutorial/body-multiple-params.md
+++ b/docs/en/docs/tutorial/body-multiple-params.md
@@ -20,7 +20,7 @@ And you can also declare body parameters as optional, by setting the default to
     {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
@@ -35,7 +35,7 @@ And you can also declare body parameters as optional, by setting the default to
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -68,7 +68,7 @@ But you can also declare multiple body parameters, e.g. `item` and `user`:
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -123,7 +123,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
     {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
@@ -138,7 +138,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
     {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -197,7 +197,7 @@ For example:
     {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="28"
     {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
@@ -212,7 +212,7 @@ For example:
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -250,7 +250,7 @@ as in:
     {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
@@ -265,7 +265,7 @@ as in:
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/body-nested-models.md b/docs/en/docs/tutorial/body-nested-models.md
index ffa0c0d0e..387f0de9a 100644
--- a/docs/en/docs/tutorial/body-nested-models.md
+++ b/docs/en/docs/tutorial/body-nested-models.md
@@ -12,7 +12,7 @@ You can define an attribute to be a subtype. For example, a Python `list`:
     {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial001.py!}
@@ -73,7 +73,7 @@ So, in our example, we can make `tags` be specifically a "list of strings":
     {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial002.py!}
@@ -99,7 +99,7 @@ Then we can declare `tags` as a set of strings:
     {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14"
     {!> ../../../docs_src/body_nested_models/tutorial003.py!}
@@ -137,7 +137,7 @@ For example, we can define an `Image` model:
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -159,7 +159,7 @@ And then we can use it as the type of an attribute:
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -183,18 +183,18 @@ This would mean that **FastAPI** would expect a body similar to:
 
 Again, doing just that declaration, with **FastAPI** you get:
 
-* Editor support (completion, etc), even for nested models
+* Editor support (completion, etc.), even for nested models
 * Data conversion
 * Data validation
 * Automatic documentation
 
 ## Special types and validation
 
-Apart from normal singular types like `str`, `int`, `float`, etc. You can use more complex singular types that inherit from `str`.
+Apart from normal singular types like `str`, `int`, `float`, etc. you can use more complex singular types that inherit from `str`.
 
 To see all the options you have, checkout the docs for <a href="https://pydantic-docs.helpmanual.io/usage/types/" class="external-link" target="_blank">Pydantic's exotic types</a>. You will see some examples in the next chapter.
 
-For example, as in the `Image` model we have a `url` field, we can declare it to be instead of a `str`, a Pydantic's `HttpUrl`:
+For example, as in the `Image` model we have a `url` field, we can declare it to be an instance of Pydantic's `HttpUrl` instead of a `str`:
 
 === "Python 3.10+"
 
@@ -208,7 +208,7 @@ For example, as in the `Image` model we have a `url` field, we can declare it to
     {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10"
     {!> ../../../docs_src/body_nested_models/tutorial005.py!}
@@ -218,7 +218,7 @@ The string will be checked to be a valid URL, and documented in JSON Schema / Op
 
 ## Attributes with lists of submodels
 
-You can also use Pydantic models as subtypes of `list`, `set`, etc:
+You can also use Pydantic models as subtypes of `list`, `set`, etc.:
 
 === "Python 3.10+"
 
@@ -232,13 +232,13 @@ You can also use Pydantic models as subtypes of `list`, `set`, etc:
     {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial006.py!}
     ```
 
-This will expect (convert, validate, document, etc) a JSON body like:
+This will expect (convert, validate, document, etc.) a JSON body like:
 
 ```JSON hl_lines="11"
 {
@@ -283,7 +283,7 @@ You can define arbitrarily deeply nested models:
     {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14  20  23  27"
     {!> ../../../docs_src/body_nested_models/tutorial007.py!}
@@ -314,7 +314,7 @@ as in:
     {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/body_nested_models/tutorial008.py!}
@@ -334,15 +334,15 @@ But you don't have to worry about them either, incoming dicts are converted auto
 
 ## Bodies of arbitrary `dict`s
 
-You can also declare a body as a `dict` with keys of some type and values of other type.
+You can also declare a body as a `dict` with keys of some type and values of some other type.
 
-Without having to know beforehand what are the valid field/attribute names (as would be the case with Pydantic models).
+This way, you don't have to know beforehand what the valid field/attribute names are (as would be the case with Pydantic models).
 
 This would be useful if you want to receive keys that you don't already know.
 
 ---
 
-Other useful case is when you want to have keys of other type, e.g. `int`.
+Another useful case is when you want to have keys of another type (e.g., `int`).
 
 That's what we are going to see here.
 
@@ -354,7 +354,7 @@ In this case, you would accept any `dict` as long as it has `int` keys with `flo
     {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/body_nested_models/tutorial009.py!}
diff --git a/docs/en/docs/tutorial/body-updates.md b/docs/en/docs/tutorial/body-updates.md
index a32948db1..3341f2d5d 100644
--- a/docs/en/docs/tutorial/body-updates.md
+++ b/docs/en/docs/tutorial/body-updates.md
@@ -18,7 +18,7 @@ You can use the `jsonable_encoder` to convert the input data to data that can be
     {!> ../../../docs_src/body_updates/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="30-35"
     {!> ../../../docs_src/body_updates/tutorial001.py!}
@@ -79,7 +79,7 @@ Then you can use this to generate a `dict` with only the data that was set (sent
     {!> ../../../docs_src/body_updates/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="34"
     {!> ../../../docs_src/body_updates/tutorial002.py!}
@@ -103,7 +103,7 @@ Like `stored_item_model.copy(update=update_data)`:
     {!> ../../../docs_src/body_updates/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="35"
     {!> ../../../docs_src/body_updates/tutorial002.py!}
@@ -136,7 +136,7 @@ In summary, to apply partial updates you would:
     {!> ../../../docs_src/body_updates/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="30-37"
     {!> ../../../docs_src/body_updates/tutorial002.py!}
diff --git a/docs/en/docs/tutorial/body.md b/docs/en/docs/tutorial/body.md
index 172b91fdf..67ba48f1e 100644
--- a/docs/en/docs/tutorial/body.md
+++ b/docs/en/docs/tutorial/body.md
@@ -25,7 +25,7 @@ First, you need to import `BaseModel` from `pydantic`:
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -43,7 +43,7 @@ Use standard Python types for all the attributes:
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7-11"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -81,7 +81,7 @@ To add it to your *path operation*, declare it the same way you declared path an
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -155,7 +155,7 @@ Inside of the function, you can access all the attributes of the model object di
     {!> ../../../docs_src/body/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/body/tutorial002.py!}
@@ -173,7 +173,7 @@ You can declare path parameters and request body at the same time.
     {!> ../../../docs_src/body/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17-18"
     {!> ../../../docs_src/body/tutorial003.py!}
@@ -191,7 +191,7 @@ You can also declare **body**, **path** and **query** parameters, all at the sam
     {!> ../../../docs_src/body/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial004.py!}
diff --git a/docs/en/docs/tutorial/cookie-params.md b/docs/en/docs/tutorial/cookie-params.md
index 111e93458..3436a7df3 100644
--- a/docs/en/docs/tutorial/cookie-params.md
+++ b/docs/en/docs/tutorial/cookie-params.md
@@ -18,7 +18,7 @@ First import `Cookie`:
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First import `Cookie`:
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -60,7 +60,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
index 498d935fe..842f2adf6 100644
--- a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -18,7 +18,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -33,7 +33,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -115,7 +115,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
     {!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12-16"
     {!> ../../../docs_src/dependencies/tutorial002_an.py!}
@@ -130,7 +130,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -153,7 +153,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="13"
     {!> ../../../docs_src/dependencies/tutorial002_an.py!}
@@ -168,7 +168,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -191,7 +191,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -206,7 +206,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -241,7 +241,7 @@ Now you can declare your dependency using this class.
     {!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/dependencies/tutorial002_an.py!}
@@ -256,7 +256,7 @@ Now you can declare your dependency using this class.
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -271,7 +271,7 @@ Now you can declare your dependency using this class.
 
 Notice how we write `CommonQueryParams` twice in the above code:
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -280,7 +280,7 @@ Notice how we write `CommonQueryParams` twice in the above code:
     commons: CommonQueryParams = Depends(CommonQueryParams)
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -300,13 +300,13 @@ From it is that FastAPI will extract the declared parameters and that is what Fa
 
 In this case, the first `CommonQueryParams`, in:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, ...
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -319,13 +319,13 @@ In this case, the first `CommonQueryParams`, in:
 
 You could actually write just:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[Any, Depends(CommonQueryParams)]
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -348,7 +348,7 @@ You could actually write just:
     {!> ../../../docs_src/dependencies/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/dependencies/tutorial003_an.py!}
@@ -363,7 +363,7 @@ You could actually write just:
     {!> ../../../docs_src/dependencies/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -380,7 +380,7 @@ But declaring the type is encouraged as that way your editor will know what will
 
 But you see that we are having some code repetition here, writing `CommonQueryParams` twice:
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -389,7 +389,7 @@ But you see that we are having some code repetition here, writing `CommonQueryPa
     commons: CommonQueryParams = Depends(CommonQueryParams)
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -401,13 +401,13 @@ For those specific cases, you can do the following:
 
 Instead of writing:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -418,13 +418,13 @@ Instead of writing:
 
 ...you write:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends()]
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -449,7 +449,7 @@ The same example would then look like:
     {!> ../../../docs_src/dependencies/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/dependencies/tutorial004_an.py!}
@@ -464,7 +464,7 @@ The same example would then look like:
     {!> ../../../docs_src/dependencies/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 935555339..eaab51d1b 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -20,13 +20,13 @@ It should be a `list` of `Depends()`:
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -35,7 +35,7 @@ It should be a `list` of `Depends()`:
     {!> ../../../docs_src/dependencies/tutorial006.py!}
     ```
 
-These dependencies will be executed/solved the same way normal dependencies. But their value (if they return any) won't be passed to your *path operation function*.
+These dependencies will be executed/solved the same way as normal dependencies. But their value (if they return any) won't be passed to your *path operation function*.
 
 !!! tip
     Some editors check for unused function parameters, and show them as errors.
@@ -63,13 +63,13 @@ They can declare request requirements (like headers) or other sub-dependencies:
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7  12"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -88,13 +88,13 @@ These dependencies can `raise` exceptions, the same as normal dependencies:
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -115,13 +115,13 @@ So, you can re-use a normal dependency (that returns a value) you already use so
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10  15"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index 8a5422ac8..fe18f1f1d 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -72,13 +72,13 @@ For example, `dependency_c` can have a dependency on `dependency_b`, and `depend
     {!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  13  21"
     {!> ../../../docs_src/dependencies/tutorial008_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -99,13 +99,13 @@ And, in turn, `dependency_b` needs the value from `dependency_a` (here named `de
     {!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17-18  25-26"
     {!> ../../../docs_src/dependencies/tutorial008_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/global-dependencies.md b/docs/en/docs/tutorial/dependencies/global-dependencies.md
index 0989b31d4..0dcf73176 100644
--- a/docs/en/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/global-dependencies.md
@@ -12,13 +12,13 @@ In that case, they will be applied to all the *path operations* in the applicati
     {!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="16"
     {!> ../../../docs_src/dependencies/tutorial012_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/index.md b/docs/en/docs/tutorial/dependencies/index.md
index f6f4bced0..bc98cb26e 100644
--- a/docs/en/docs/tutorial/dependencies/index.md
+++ b/docs/en/docs/tutorial/dependencies/index.md
@@ -43,7 +43,7 @@ It is just a function that can take all the same parameters that a *path operati
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-12"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -58,7 +58,7 @@ It is just a function that can take all the same parameters that a *path operati
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -106,7 +106,7 @@ And then it just returns a `dict` containing those values.
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -121,7 +121,7 @@ And then it just returns a `dict` containing those values.
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -146,7 +146,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="16  21"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -161,7 +161,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -231,7 +231,7 @@ But because we are using `Annotated`, we can store that `Annotated` value in a v
     {!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15  19  24"
     {!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
diff --git a/docs/en/docs/tutorial/dependencies/sub-dependencies.md b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
index b50de1a46..1cb469a80 100644
--- a/docs/en/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
@@ -22,7 +22,7 @@ You could create a first dependency ("dependable") like:
     {!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-10"
     {!> ../../../docs_src/dependencies/tutorial005_an.py!}
@@ -37,7 +37,7 @@ You could create a first dependency ("dependable") like:
     {!> ../../../docs_src/dependencies/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -66,7 +66,7 @@ Then you can create another dependency function (a "dependable") that at the sam
     {!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/dependencies/tutorial005_an.py!}
@@ -81,7 +81,7 @@ Then you can create another dependency function (a "dependable") that at the sam
     {!> ../../../docs_src/dependencies/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -113,7 +113,7 @@ Then we can use the dependency with:
     {!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/dependencies/tutorial005_an.py!}
@@ -128,7 +128,7 @@ Then we can use the dependency with:
     {!> ../../../docs_src/dependencies/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -161,14 +161,14 @@ And it will save the returned value in a <abbr title="A utility/system to store
 
 In an advanced scenario where you know you need the dependency to be called at every step (possibly multiple times) in the same request instead of using the "cached" value, you can set the parameter `use_cache=False` when using `Depends`:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_cache=False)]):
         return {"fresh_value": fresh_value}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/encoder.md b/docs/en/docs/tutorial/encoder.md
index 735aa2209..845cc25fc 100644
--- a/docs/en/docs/tutorial/encoder.md
+++ b/docs/en/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@ It receives an object, like a Pydantic model, and returns a JSON compatible vers
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/en/docs/tutorial/extra-data-types.md b/docs/en/docs/tutorial/extra-data-types.md
index 7d6ffbc78..fd7a99af3 100644
--- a/docs/en/docs/tutorial/extra-data-types.md
+++ b/docs/en/docs/tutorial/extra-data-types.md
@@ -49,7 +49,7 @@ Here are some of the additional data types you can use:
 * `Decimal`:
     * Standard Python `Decimal`.
     * In requests and responses, handled the same as a `float`.
-* You can check all the valid pydantic data types here: <a href="https://pydantic-docs.helpmanual.io/usage/types" class="external-link" target="_blank">Pydantic data types</a>.
+* You can check all the valid pydantic data types here: <a href="https://docs.pydantic.dev/latest/usage/types/types/" class="external-link" target="_blank">Pydantic data types</a>.
 
 ## Example
 
@@ -67,7 +67,7 @@ Here's an example *path operation* with parameters using some of the above types
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  3  13-17"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -82,7 +82,7 @@ Here's an example *path operation* with parameters using some of the above types
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -105,7 +105,7 @@ Note that the parameters inside the function have their natural data type, and y
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-20"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -120,7 +120,7 @@ Note that the parameters inside the function have their natural data type, and y
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/extra-models.md b/docs/en/docs/tutorial/extra-models.md
index e91e879e4..590d095bd 100644
--- a/docs/en/docs/tutorial/extra-models.md
+++ b/docs/en/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@ Here's a general idea of how the models could look like with their password fiel
     {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -164,7 +164,7 @@ That way, we can declare just the differences between the models (with plaintext
     {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -187,7 +187,7 @@ To do that, use the standard Python type hint <a href="https://docs.python.org/3
     {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -219,7 +219,7 @@ For that, use the standard Python `typing.List` (or just `list` in Python 3.9 an
     {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -239,7 +239,7 @@ In this case, you can use `typing.Dict` (or just `dict` in Python 3.9 and above)
     {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/en/docs/tutorial/handling-errors.md b/docs/en/docs/tutorial/handling-errors.md
index 8c30326ce..a03029e81 100644
--- a/docs/en/docs/tutorial/handling-errors.md
+++ b/docs/en/docs/tutorial/handling-errors.md
@@ -1,6 +1,6 @@
 # Handling Errors
 
-There are many situations in where you need to notify an error to a client that is using your API.
+There are many situations in which you need to notify an error to a client that is using your API.
 
 This client could be a browser with a frontend, a code from someone else, an IoT device, etc.
 
diff --git a/docs/en/docs/tutorial/header-params.md b/docs/en/docs/tutorial/header-params.md
index 9e928cdc6..bbba90998 100644
--- a/docs/en/docs/tutorial/header-params.md
+++ b/docs/en/docs/tutorial/header-params.md
@@ -18,7 +18,7 @@ First import `Header`:
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First import `Header`:
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -60,7 +60,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -120,7 +120,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
     {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/header_params/tutorial002_an.py!}
@@ -135,7 +135,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
     {!> ../../../docs_src/header_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -169,7 +169,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
     {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial003_an.py!}
@@ -193,7 +193,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
     {!> ../../../docs_src/header_params/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/metadata.md b/docs/en/docs/tutorial/metadata.md
index e75b4a0b9..504204e98 100644
--- a/docs/en/docs/tutorial/metadata.md
+++ b/docs/en/docs/tutorial/metadata.md
@@ -14,7 +14,7 @@ You can set the following fields that are used in the OpenAPI specification and
 | `version` | `string` | The version of the API. This is the version of your own application, not of OpenAPI. For example `2.5.0`. |
 | `terms_of_service` | `str` | A URL to the Terms of Service for the API. If provided, this has to be a URL. |
 | `contact` | `dict` | The contact information for the exposed API. It can contain several fields. <details><summary><code>contact</code> fields</summary><table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td>The identifying name of the contact person/organization.</td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>The URL pointing to the contact information. MUST be in the format of a URL.</td></tr><tr><td><code>email</code></td><td><code>str</code></td><td>The email address of the contact person/organization. MUST be in the format of an email address.</td></tr></tbody></table></details> |
-| `license_info` | `dict` | The license information for the exposed API. It can contain several fields. <details><summary><code>license_info</code> fields</summary><table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td><strong>REQUIRED</strong> (if a <code>license_info</code> is set). The license name used for the API.</td></tr><tr><td><code>identifier</code></td><td><code>str</code></td><td>An <a href="https://spdx.dev/spdx-specification-21-web-version/#h.jxpfx0ykyb60" class="external-link" target="_blank">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field. <small>Available since OpenAPI 3.1.0, FastAPI 0.99.0.</small></td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>A URL to the license used for the API. MUST be in the format of a URL.</td></tr></tbody></table></details> |
+| `license_info` | `dict` | The license information for the exposed API. It can contain several fields. <details><summary><code>license_info</code> fields</summary><table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td><strong>REQUIRED</strong> (if a <code>license_info</code> is set). The license name used for the API.</td></tr><tr><td><code>identifier</code></td><td><code>str</code></td><td>An <a href="https://spdx.org/licenses/" class="external-link" target="_blank">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field. <small>Available since OpenAPI 3.1.0, FastAPI 0.99.0.</small></td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>A URL to the license used for the API. MUST be in the format of a URL.</td></tr></tbody></table></details> |
 
 You can set them as follows:
 
diff --git a/docs/en/docs/tutorial/path-operation-configuration.md b/docs/en/docs/tutorial/path-operation-configuration.md
index 7d4d4bcca..babf85acb 100644
--- a/docs/en/docs/tutorial/path-operation-configuration.md
+++ b/docs/en/docs/tutorial/path-operation-configuration.md
@@ -25,7 +25,7 @@ But if you don't remember what each number code is for, you can use the shortcut
     {!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  17"
     {!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
@@ -54,7 +54,7 @@ You can add tags to your *path operation*, pass the parameter `tags` with a `lis
     {!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  27"
     {!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
@@ -92,7 +92,7 @@ You can add a `summary` and `description`:
     {!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20-21"
     {!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
@@ -116,7 +116,7 @@ You can write <a href="https://en.wikipedia.org/wiki/Markdown" class="external-l
     {!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-27"
     {!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
@@ -142,7 +142,7 @@ You can specify the response description with the parameter `response_descriptio
     {!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
diff --git a/docs/en/docs/tutorial/path-params-numeric-validations.md b/docs/en/docs/tutorial/path-params-numeric-validations.md
index 9255875d6..57ad20b13 100644
--- a/docs/en/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/en/docs/tutorial/path-params-numeric-validations.md
@@ -18,7 +18,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3-4"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -67,7 +67,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -82,7 +82,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -117,7 +117,7 @@ It doesn't matter for **FastAPI**. It will detect the parameters by their names,
 
 So, you can declare your function as:
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -134,7 +134,7 @@ But have in mind that if you use `Annotated`, you won't have this problem, it wo
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
@@ -174,7 +174,7 @@ Have in mind that if you use `Annotated`, as you are not using function paramete
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
@@ -192,13 +192,13 @@ Here, with `ge=1`, `item_id` will need to be an integer number "`g`reater than o
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -220,13 +220,13 @@ The same applies for:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -251,13 +251,13 @@ And the same for <abbr title="less than"><code>lt</code></abbr>.
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/path-params.md b/docs/en/docs/tutorial/path-params.md
index 6594a7a8b..847b56334 100644
--- a/docs/en/docs/tutorial/path-params.md
+++ b/docs/en/docs/tutorial/path-params.md
@@ -46,16 +46,18 @@ But if you go to the browser at <a href="http://127.0.0.1:8000/items/foo" class=
 
 ```JSON
 {
-    "detail": [
-        {
-            "loc": [
-                "path",
-                "item_id"
-            ],
-            "msg": "value is not a valid integer",
-            "type": "type_error.integer"
-        }
-    ]
+  "detail": [
+    {
+      "type": "int_parsing",
+      "loc": [
+        "path",
+        "item_id"
+      ],
+      "msg": "Input should be a valid integer, unable to parse string as an integer",
+      "input": "foo",
+      "url": "https://errors.pydantic.dev/2.1/v/int_parsing"
+    }
+  ]
 }
 ```
 
diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index f87adddcb..91ae615ff 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@ Let's take this application as example:
     {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
@@ -42,7 +42,7 @@ To achieve that, first import:
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     In versions of Python below Python 3.9 you import `Annotated` from `typing_extensions`.
 
@@ -73,7 +73,7 @@ We had this type annotation:
     q: str | None = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Union[str, None] = None
@@ -87,7 +87,7 @@ What we will do is wrap that with `Annotated`, so it becomes:
     q: Annotated[str | None] = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Annotated[Union[str, None]] = None
@@ -107,7 +107,7 @@ Now that we have this `Annotated` where we can put more metadata, add `Query` to
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
@@ -138,7 +138,7 @@ This is how you would use `Query()` as the default value of your function parame
     {!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
@@ -251,7 +251,7 @@ You can also add a parameter `min_length`:
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
@@ -266,7 +266,7 @@ You can also add a parameter `min_length`:
     {!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -291,7 +291,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
@@ -306,7 +306,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
     {!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -351,13 +351,13 @@ Let's say that you want to declare the `q` query parameter to have a `min_length
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -405,13 +405,13 @@ So, when you need to declare a value as required while using `Query`, you can si
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -435,13 +435,13 @@ There's an alternative way to explicitly declare that a value is required. You c
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -475,7 +475,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
@@ -490,7 +490,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -502,33 +502,8 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
 !!! tip
     Pydantic, which is what powers all the data validation and serialization in FastAPI, has a special behavior when you use `Optional` or `Union[Something, None]` without a default value, you can read more about it in the Pydantic docs about <a href="https://pydantic-docs.helpmanual.io/usage/models/#required-optional-fields" class="external-link" target="_blank">Required Optional fields</a>.
 
-### Use Pydantic's `Required` instead of Ellipsis (`...`)
-
-If you feel uncomfortable using `...`, you can also import and use `Required` from Pydantic:
-
-=== "Python 3.9+"
-
-    ```Python hl_lines="4  10"
-    {!> ../../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
-    ```
-
-=== "Python 3.6+"
-
-    ```Python hl_lines="2  9"
-    {!> ../../../docs_src/query_params_str_validations/tutorial006d_an.py!}
-    ```
-
-=== "Python 3.6+ non-Annotated"
-
-    !!! tip
-        Prefer to use the `Annotated` version if possible.
-
-    ```Python hl_lines="2  8"
-    {!> ../../../docs_src/query_params_str_validations/tutorial006d.py!}
-    ```
-
 !!! tip
-    Remember that in most of the cases, when something is required, you can simply omit the default, so you normally don't have to use `...` nor `Required`.
+    Remember that in most of the cases, when something is required, you can simply omit the default, so you normally don't have to use `...`.
 
 ## Query parameter list / multiple values
 
@@ -548,7 +523,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
@@ -572,7 +547,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
     {!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -617,7 +592,7 @@ And you can also define a default `list` of values if none are provided:
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
@@ -632,7 +607,7 @@ And you can also define a default `list` of values if none are provided:
     {!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -668,13 +643,13 @@ You can also use `list` directly instead of `List[str]` (or `list[str]` in Pytho
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -713,7 +688,7 @@ You can add a `title`:
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
@@ -728,7 +703,7 @@ You can add a `title`:
     {!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -751,7 +726,7 @@ And a `description`:
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
@@ -762,11 +737,11 @@ And a `description`:
     !!! tip
         Prefer to use the `Annotated` version if possible.
 
-    ```Python hl_lines="12"
+    ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -805,7 +780,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
@@ -820,7 +795,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
     {!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -849,7 +824,7 @@ Then pass the parameter `deprecated=True` to `Query`:
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
@@ -860,11 +835,11 @@ Then pass the parameter `deprecated=True` to `Query`:
     !!! tip
         Prefer to use the `Annotated` version if possible.
 
-    ```Python hl_lines="17"
+    ```Python hl_lines="16"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -893,7 +868,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
@@ -908,7 +883,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
     {!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -932,7 +907,7 @@ Validations specific for strings:
 
 * `min_length`
 * `max_length`
-* `regex`
+* `pattern`
 
 In these examples you saw how to declare validations for `str` values.
 
diff --git a/docs/en/docs/tutorial/query-params.md b/docs/en/docs/tutorial/query-params.md
index 0b74b10f8..bc3b11948 100644
--- a/docs/en/docs/tutorial/query-params.md
+++ b/docs/en/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ The same way, you can declare optional query parameters, by setting their defaul
     {!> ../../../docs_src/query_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial002.py!}
@@ -90,7 +90,7 @@ You can also declare `bool` types, and they will be converted:
     {!> ../../../docs_src/query_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial003.py!}
@@ -143,7 +143,7 @@ They will be detected by name:
     {!> ../../../docs_src/query_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  10"
     {!> ../../../docs_src/query_params/tutorial004.py!}
@@ -173,16 +173,18 @@ http://127.0.0.1:8000/items/foo-item
 
 ```JSON
 {
-    "detail": [
-        {
-            "loc": [
-                "query",
-                "needy"
-            ],
-            "msg": "field required",
-            "type": "value_error.missing"
-        }
-    ]
+  "detail": [
+    {
+      "type": "missing",
+      "loc": [
+        "query",
+        "needy"
+      ],
+      "msg": "Field required",
+      "input": null,
+      "url": "https://errors.pydantic.dev/2.1/v/missing"
+    }
+  ]
 }
 ```
 
@@ -209,7 +211,7 @@ And of course, you can define some parameters as required, some as having a defa
     {!> ../../../docs_src/query_params/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params/tutorial006.py!}
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index 1fe1e7a33..c85a68ed6 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -19,13 +19,13 @@ Import `File` and `UploadFile` from `fastapi`:
     {!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -44,13 +44,13 @@ Create file parameters the same way you would for `Body` or `Form`:
     {!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/request_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -85,13 +85,13 @@ Define a file parameter with a type of `UploadFile`:
     {!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="13"
     {!> ../../../docs_src/request_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -181,7 +181,7 @@ You can make a file optional by using standard type annotations and setting a de
     {!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10  18"
     {!> ../../../docs_src/request_files/tutorial001_02_an.py!}
@@ -196,7 +196,7 @@ You can make a file optional by using standard type annotations and setting a de
     {!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -215,13 +215,13 @@ You can also use `File()` with `UploadFile`, for example, to set additional meta
     {!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  14"
     {!> ../../../docs_src/request_files/tutorial001_03_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -244,7 +244,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
     {!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11  16"
     {!> ../../../docs_src/request_files/tutorial002_an.py!}
@@ -259,7 +259,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
     {!> ../../../docs_src/request_files/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -285,7 +285,7 @@ And the same way as before, you can use `File()` to set additional parameters, e
     {!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12  19-21"
     {!> ../../../docs_src/request_files/tutorial003_an.py!}
@@ -300,7 +300,7 @@ And the same way as before, you can use `File()` to set additional parameters, e
     {!> ../../../docs_src/request_files/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/request-forms-and-files.md b/docs/en/docs/tutorial/request-forms-and-files.md
index 1818946c4..a58291dc8 100644
--- a/docs/en/docs/tutorial/request-forms-and-files.md
+++ b/docs/en/docs/tutorial/request-forms-and-files.md
@@ -15,13 +15,13 @@ You can define files and form fields at the same time using `File` and `Form`.
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -40,13 +40,13 @@ Create file and form parameters the same way you would for `Body` or `Query`:
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/request-forms.md b/docs/en/docs/tutorial/request-forms.md
index 5d441a614..0e8ac5f4f 100644
--- a/docs/en/docs/tutorial/request-forms.md
+++ b/docs/en/docs/tutorial/request-forms.md
@@ -17,13 +17,13 @@ Import `Form` from `fastapi`:
     {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_forms/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -42,13 +42,13 @@ Create form parameters the same way you would for `Body` or `Query`:
     {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/request_forms/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/response-model.md b/docs/en/docs/tutorial/response-model.md
index 2181cfb5a..d6d3d61cb 100644
--- a/docs/en/docs/tutorial/response-model.md
+++ b/docs/en/docs/tutorial/response-model.md
@@ -16,7 +16,7 @@ You can use **type annotations** the same way you would for input data in functi
     {!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18  23"
     {!> ../../../docs_src/response_model/tutorial001_01.py!}
@@ -65,7 +65,7 @@ You can use the `response_model` parameter in any of the *path operations*:
     {!> ../../../docs_src/response_model/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  24-27"
     {!> ../../../docs_src/response_model/tutorial001.py!}
@@ -101,7 +101,7 @@ Here we are declaring a `UserIn` model, it will contain a plaintext password:
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -121,7 +121,7 @@ And we are using this model to declare our input and the same model to declare o
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -146,7 +146,7 @@ We can instead create an input model with the plaintext password and an output m
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -160,7 +160,7 @@ Here, even though our *path operation function* is returning the same input user
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -174,7 +174,7 @@ Here, even though our *path operation function* is returning the same input user
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -208,7 +208,7 @@ And in those cases, we can use classes and inheritance to take advantage of func
     {!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-13  15-16  20"
     {!> ../../../docs_src/response_model/tutorial003_01.py!}
@@ -284,7 +284,7 @@ The same would happen if you had something like a <abbr title='A union between m
     {!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/response_model/tutorial003_04.py!}
@@ -306,7 +306,7 @@ In this case, you can disable the response model generation by setting `response
     {!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/response_model/tutorial003_05.py!}
@@ -330,7 +330,7 @@ Your response model could have default values, like:
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11  13-14"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -360,7 +360,7 @@ You can set the *path operation decorator* parameter `response_model_exclude_uns
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -447,7 +447,7 @@ This can be used as a quick shortcut if you have only one Pydantic model and wan
     {!> ../../../docs_src/response_model/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial005.py!}
@@ -468,7 +468,7 @@ If you forget to use a `set` and use a `list` or `tuple` instead, FastAPI will s
     {!> ../../../docs_src/response_model/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial006.py!}
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 39d184763..9bb9ba4e3 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -20,13 +20,13 @@ You can declare `examples` for a Pydantic model that will be added to the genera
     {!> ../../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
     ```
 
-=== "Python 3.6+ Pydantic v2"
+=== "Python 3.8+ Pydantic v2"
 
     ```Python hl_lines="15-26"
     {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
     ```
 
-=== "Python 3.6+ Pydantic v1"
+=== "Python 3.8+ Pydantic v1"
 
     ```Python hl_lines="15-25"
     {!> ../../../docs_src/schema_extra_example/tutorial001_pv1.py!}
@@ -38,13 +38,13 @@ That extra info will be added as-is to the output **JSON Schema** for that model
 
     In Pydantic version 2, you would use the attribute `model_config`, that takes a `dict` as described in <a href="https://docs.pydantic.dev/latest/usage/model_config/" class="external-link" target="_blank">Pydantic's docs: Model Config</a>.
 
-    You can set `"json_schema_extra"` with a `dict` containing any additonal data you would like to show up in the generated JSON Schema, including `examples`.
+    You can set `"json_schema_extra"` with a `dict` containing any additional data you would like to show up in the generated JSON Schema, including `examples`.
 
 === "Pydantic v1"
 
     In Pydantic version 1, you would use an internal class `Config` and `schema_extra`, as described in <a href="https://docs.pydantic.dev/1.10/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic's docs: Schema customization</a>.
 
-    You can set `schema_extra` with a `dict` containing any additonal data you would like to show up in the generated JSON Schema, including `examples`.
+    You can set `schema_extra` with a `dict` containing any additional data you would like to show up in the generated JSON Schema, including `examples`.
 
 !!! tip
     You could use the same technique to extend the JSON Schema and add your own custom extra info.
@@ -68,13 +68,13 @@ When using `Field()` with Pydantic models, you can also declare additional `exam
     {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10-13"
     {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
     ```
 
-## `examples` in OpenAPI
+## `examples` in JSON Schema - OpenAPI
 
 When using any of:
 
@@ -86,7 +86,7 @@ When using any of:
 * `Form()`
 * `File()`
 
-you can also declare a group of `examples` with additional information that will be added to **OpenAPI**.
+you can also declare a group of `examples` with additional information that will be added to their **JSON Schemas** inside of **OpenAPI**.
 
 ### `Body` with `examples`
 
@@ -104,7 +104,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
     {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-30"
     {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
@@ -119,7 +119,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
     {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -150,7 +150,7 @@ You can of course also pass multiple `examples`:
     {!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24-39"
     {!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
@@ -165,7 +165,7 @@ You can of course also pass multiple `examples`:
     {!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -174,9 +174,84 @@ You can of course also pass multiple `examples`:
     {!> ../../../docs_src/schema_extra_example/tutorial004.py!}
     ```
 
-### Examples in the docs UI
+When you do this, the examples will be part of the internal **JSON Schema** for that body data.
 
-With `examples` added to `Body()` the `/docs` would look like:
+Nevertheless, at the <abbr title="2023-08-26">time of writing this</abbr>, Swagger UI, the tool in charge of showing the docs UI, doesn't support showing multiple examples for the data in **JSON Schema**. But read below for a workaround.
+
+### OpenAPI-specific `examples`
+
+Since before **JSON Schema** supported `examples` OpenAPI had support for a different field also called `examples`.
+
+This **OpenAPI-specific** `examples` goes in another section in the OpenAPI specification. It goes in the **details for each *path operation***, not inside each JSON Schema.
+
+And Swagger UI has supported this particular `examples` field for a while. So, you can use it to **show** different **examples in the docs UI**.
+
+The shape of this OpenAPI-specific field `examples` is a `dict` with **multiple examples** (instead of a `list`), each with extra information that will be added to **OpenAPI** too.
+
+This doesn't go inside of each JSON Schema contained in OpenAPI, this goes outside, in the *path operation* directly.
+
+### Using the `openapi_examples` Parameter
+
+You can declare the OpenAPI-specific `examples` in FastAPI with the parameter `openapi_examples` for:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+The keys of the `dict` identify each example, and each value is another `dict`.
+
+Each specific example `dict` in the `examples` can contain:
+
+* `summary`: Short description for the example.
+* `description`: A long description that can contain Markdown text.
+* `value`: This is the actual example shown, e.g. a `dict`.
+* `externalValue`: alternative to `value`, a URL pointing to the example. Although this might not be supported by as many tools as `value`.
+
+You can use it like this:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="23-49"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="23-49"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="24-50"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="19-45"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="21-47"
+    {!> ../../../docs_src/schema_extra_example/tutorial005.py!}
+    ```
+
+### OpenAPI Examples in the Docs UI
+
+With `openapi_examples` added to `Body()` the `/docs` would look like:
 
 <img src="/img/tutorial/body-fields/image02.png">
 
@@ -210,20 +285,8 @@ OpenAPI also added `example` and `examples` fields to other parts of the specifi
     * `File()`
     * `Form()`
 
-### OpenAPI's `examples` field
-
-The shape of this field `examples` from OpenAPI is a `dict` with **multiple examples**, each with extra information that will be added to **OpenAPI** too.
-
-The keys of the `dict` identify each example, and each value is another `dict`.
-
-Each specific example `dict` in the `examples` can contain:
-
-* `summary`: Short description for the example.
-* `description`: A long description that can contain Markdown text.
-* `value`: This is the actual example shown, e.g. a `dict`.
-* `externalValue`: alternative to `value`, a URL pointing to the example. Although this might not be supported by as many tools as `value`.
-
-This applies to those other parts of the OpenAPI specification apart from JSON Schema.
+!!! info
+    This old OpenAPI-specific `examples` parameter is now `openapi_examples` since FastAPI `0.103.0`.
 
 ### JSON Schema's `examples` field
 
@@ -250,6 +313,12 @@ In versions of FastAPI before 0.99.0 (0.99.0 and above use the newer OpenAPI 3.1
 
 But now that FastAPI 0.99.0 and above uses OpenAPI 3.1.0, that uses JSON Schema 2020-12, and Swagger UI 5.0.0 and above, everything is more consistent and the examples are included in JSON Schema.
 
+### Swagger UI and OpenAPI-specific `examples`
+
+Now, as Swagger UI didn't support multiple JSON Schema examples (as of 2023-08-26), users didn't have a way to show multiple examples in the docs.
+
+To solve that, FastAPI `0.103.0` **added support** for declaring the same old **OpenAPI-specific** `examples` field with the new parameter `openapi_examples`. 🤓
+
 ### Summary
 
 I used to say I didn't like history that much... and look at me now giving "tech history" lessons. 😅
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index 5765cf2d6..2f39f1ec2 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -26,13 +26,13 @@ Copy the example in a file `main.py`:
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -140,13 +140,13 @@ When we create an instance of the `OAuth2PasswordBearer` class we pass in the `t
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python  hl_lines="7"
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -191,13 +191,13 @@ Now you can pass that `oauth2_scheme` in a dependency with `Depends`.
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python  hl_lines="11"
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/get-current-user.md b/docs/en/docs/tutorial/security/get-current-user.md
index 1a8c5d9a8..e99a800c6 100644
--- a/docs/en/docs/tutorial/security/get-current-user.md
+++ b/docs/en/docs/tutorial/security/get-current-user.md
@@ -8,13 +8,13 @@ In the previous chapter the security system (which is based on the dependency in
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -45,7 +45,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  13-17"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -60,7 +60,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -91,7 +91,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="26"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -106,7 +106,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -131,7 +131,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20-23  27-28"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -146,7 +146,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -171,7 +171,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="32"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -186,7 +186,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -253,7 +253,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31-33"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -268,7 +268,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/oauth2-jwt.md b/docs/en/docs/tutorial/security/oauth2-jwt.md
index deb722b96..0a347fed3 100644
--- a/docs/en/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/en/docs/tutorial/security/oauth2-jwt.md
@@ -121,7 +121,7 @@ And another one to authenticate and return a user.
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7  49  56-57  60-61  70-76"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -136,7 +136,7 @@ And another one to authenticate and return a user.
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -188,7 +188,7 @@ Create a utility function to generate a new access token.
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="6  13-15  29-31 79-87"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -203,7 +203,7 @@ Create a utility function to generate a new access token.
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -232,7 +232,7 @@ If the token is invalid, return an HTTP error right away.
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="90-107"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -247,7 +247,7 @@ If the token is invalid, return an HTTP error right away.
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -274,7 +274,7 @@ Create a real JWT access token and return it
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="118-133"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -289,7 +289,7 @@ Create a real JWT access token and return it
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/simple-oauth2.md b/docs/en/docs/tutorial/security/simple-oauth2.md
index abcf6b667..88edc9eab 100644
--- a/docs/en/docs/tutorial/security/simple-oauth2.md
+++ b/docs/en/docs/tutorial/security/simple-oauth2.md
@@ -61,7 +61,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  79"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -76,7 +76,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -134,7 +134,7 @@ For the error, we use the exception `HTTPException`:
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  80-82"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -149,7 +149,7 @@ For the error, we use the exception `HTTPException`:
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -194,7 +194,7 @@ So, the thief won't be able to try to use those same passwords in another system
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="83-86"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -209,7 +209,7 @@ So, the thief won't be able to try to use those same passwords in another system
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -264,7 +264,7 @@ For this simple example, we are going to just be completely insecure and return
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="88"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -279,7 +279,7 @@ For this simple example, we are going to just be completely insecure and return
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -321,7 +321,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="59-67  70-75  95"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -336,7 +336,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/sql-databases.md b/docs/en/docs/tutorial/sql-databases.md
index 6e0e5dc06..010244bbf 100644
--- a/docs/en/docs/tutorial/sql-databases.md
+++ b/docs/en/docs/tutorial/sql-databases.md
@@ -281,7 +281,7 @@ But for security, the `password` won't be in other Pydantic *models*, for exampl
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  6-8  11-12  23-24  27-28"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -325,7 +325,7 @@ Not only the IDs of those items, but all the data that we defined in the Pydanti
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-17  31-34"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -354,7 +354,7 @@ In the `Config` class, set the attribute `orm_mode = True`.
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15  19-20  31  36-37"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -494,7 +494,7 @@ In a very simplistic way create the database tables:
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -528,7 +528,7 @@ Our dependency will create a new SQLAlchemy `SessionLocal` that will be used in
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-20"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -553,7 +553,7 @@ This will then give us better editor support inside the *path operation function
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24  32  38  47  53"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -574,7 +574,7 @@ Now, finally, here's the standard **FastAPI** *path operations* code.
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28  31-34  37-42  45-49  52-55"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -673,7 +673,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -693,7 +693,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -752,7 +752,7 @@ The middleware we'll add (just a function) will create a new SQLAlchemy `Session
     {!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14-22"
     {!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
diff --git a/docs/en/docs/tutorial/testing.md b/docs/en/docs/tutorial/testing.md
index ec133a4d0..3f8dd69a1 100644
--- a/docs/en/docs/tutorial/testing.md
+++ b/docs/en/docs/tutorial/testing.md
@@ -122,7 +122,7 @@ Both *path operations* require an `X-Token` header.
     {!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/app_testing/app_b_an/main.py!}
@@ -137,7 +137,7 @@ Both *path operations* require an `X-Token` header.
     {!> ../../../docs_src/app_testing/app_b_py310/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 030bbe5d3..a64eff269 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -30,6 +30,7 @@ theme:
   - content.code.annotate
   - content.code.copy
   - content.code.select
+  - navigation.tabs
   icon:
     repo: fontawesome/brands/github-alt
   logo: img/icon-white.svg
@@ -42,132 +43,184 @@ plugins:
   search: null
   markdownextradata:
     data: ../en/data
+  redirects:
+    redirect_maps:
+      deployment/deta.md: deployment/cloud.md
+      advanced/sql-databases-peewee.md: how-to/sql-databases-peewee.md
+      advanced/async-sql-databases.md: how-to/async-sql-encode-databases.md
+      advanced/nosql-databases.md: how-to/nosql-databases-couchbase.md
+      advanced/graphql.md: how-to/graphql.md
+      advanced/custom-request-and-route.md: how-to/custom-request-and-route.md
+      advanced/conditional-openapi.md: how-to/conditional-openapi.md
+      advanced/extending-openapi.md: how-to/extending-openapi.md
+  mkdocstrings:
+    handlers:
+      python:
+        options:
+          extensions:
+            - griffe_typingdoc
+          show_root_heading: true
+          show_if_no_docstring: true
+          preload_modules: [httpx, starlette]
+          inherited_members: true
+          members_order: source
+          separate_signature: true
+          unwrap_annotated: true
+          filters: ["!^_"]
+          merge_init_into_class: true
+          docstring_section_style: spacy
+          signature_crossrefs: true
+          show_symbol_type_heading: true
+          show_symbol_type_toc: true
 nav:
 - FastAPI: index.md
-- Languages:
-  - en: /
-  - de: /de/
-  - em: /em/
-  - es: /es/
-  - fa: /fa/
-  - fr: /fr/
-  - he: /he/
-  - id: /id/
-  - ja: /ja/
-  - ko: /ko/
-  - pl: /pl/
-  - pt: /pt/
-  - ru: /ru/
-  - tr: /tr/
-  - zh: /zh/
 - features.md
+- Learn:
+  - learn/index.md
+  - python-types.md
+  - async.md
+  - Tutorial - User Guide:
+    - tutorial/index.md
+    - tutorial/first-steps.md
+    - tutorial/path-params.md
+    - tutorial/query-params.md
+    - tutorial/body.md
+    - tutorial/query-params-str-validations.md
+    - tutorial/path-params-numeric-validations.md
+    - tutorial/body-multiple-params.md
+    - tutorial/body-fields.md
+    - tutorial/body-nested-models.md
+    - tutorial/schema-extra-example.md
+    - tutorial/extra-data-types.md
+    - tutorial/cookie-params.md
+    - tutorial/header-params.md
+    - tutorial/response-model.md
+    - tutorial/extra-models.md
+    - tutorial/response-status-code.md
+    - tutorial/request-forms.md
+    - tutorial/request-files.md
+    - tutorial/request-forms-and-files.md
+    - tutorial/handling-errors.md
+    - tutorial/path-operation-configuration.md
+    - tutorial/encoder.md
+    - tutorial/body-updates.md
+    - Dependencies:
+      - tutorial/dependencies/index.md
+      - tutorial/dependencies/classes-as-dependencies.md
+      - tutorial/dependencies/sub-dependencies.md
+      - tutorial/dependencies/dependencies-in-path-operation-decorators.md
+      - tutorial/dependencies/global-dependencies.md
+      - tutorial/dependencies/dependencies-with-yield.md
+    - Security:
+      - tutorial/security/index.md
+      - tutorial/security/first-steps.md
+      - tutorial/security/get-current-user.md
+      - tutorial/security/simple-oauth2.md
+      - tutorial/security/oauth2-jwt.md
+    - tutorial/middleware.md
+    - tutorial/cors.md
+    - tutorial/sql-databases.md
+    - tutorial/bigger-applications.md
+    - tutorial/background-tasks.md
+    - tutorial/metadata.md
+    - tutorial/static-files.md
+    - tutorial/testing.md
+    - tutorial/debugging.md
+  - Advanced User Guide:
+    - advanced/index.md
+    - advanced/path-operation-advanced-configuration.md
+    - advanced/additional-status-codes.md
+    - advanced/response-directly.md
+    - advanced/custom-response.md
+    - advanced/additional-responses.md
+    - advanced/response-cookies.md
+    - advanced/response-headers.md
+    - advanced/response-change-status-code.md
+    - advanced/advanced-dependencies.md
+    - Advanced Security:
+      - advanced/security/index.md
+      - advanced/security/oauth2-scopes.md
+      - advanced/security/http-basic-auth.md
+    - advanced/using-request-directly.md
+    - advanced/dataclasses.md
+    - advanced/middleware.md
+    - advanced/sub-applications.md
+    - advanced/behind-a-proxy.md
+    - advanced/templates.md
+    - advanced/websockets.md
+    - advanced/events.md
+    - advanced/testing-websockets.md
+    - advanced/testing-events.md
+    - advanced/testing-dependencies.md
+    - advanced/testing-database.md
+    - advanced/async-tests.md
+    - advanced/settings.md
+    - advanced/openapi-callbacks.md
+    - advanced/openapi-webhooks.md
+    - advanced/wsgi.md
+    - advanced/generate-clients.md
+  - Deployment:
+    - deployment/index.md
+    - deployment/versions.md
+    - deployment/https.md
+    - deployment/manually.md
+    - deployment/concepts.md
+    - deployment/cloud.md
+    - deployment/server-workers.md
+    - deployment/docker.md
+  - How To - Recipes:
+    - how-to/index.md
+    - how-to/general.md
+    - how-to/sql-databases-peewee.md
+    - how-to/async-sql-encode-databases.md
+    - how-to/nosql-databases-couchbase.md
+    - how-to/graphql.md
+    - how-to/custom-request-and-route.md
+    - how-to/conditional-openapi.md
+    - how-to/extending-openapi.md
+    - how-to/separate-openapi-schemas.md
+    - how-to/custom-docs-ui-assets.md
+    - how-to/configure-swagger-ui.md
+- Reference (Code API):
+  - reference/index.md
+  - reference/fastapi.md
+  - reference/parameters.md
+  - reference/status.md
+  - reference/uploadfile.md
+  - reference/exceptions.md
+  - reference/dependencies.md
+  - reference/apirouter.md
+  - reference/background.md
+  - reference/request.md
+  - reference/websockets.md
+  - reference/httpconnection.md
+  - reference/response.md
+  - reference/responses.md
+  - reference/middleware.md
+  - OpenAPI:
+    - reference/openapi/index.md
+    - reference/openapi/docs.md
+    - reference/openapi/models.md
+  - reference/security/index.md
+  - reference/encoders.md
+  - reference/staticfiles.md
+  - reference/templating.md
+  - reference/testclient.md
 - fastapi-people.md
-- python-types.md
-- Tutorial - User Guide:
-  - tutorial/index.md
-  - tutorial/first-steps.md
-  - tutorial/path-params.md
-  - tutorial/query-params.md
-  - tutorial/body.md
-  - tutorial/query-params-str-validations.md
-  - tutorial/path-params-numeric-validations.md
-  - tutorial/body-multiple-params.md
-  - tutorial/body-fields.md
-  - tutorial/body-nested-models.md
-  - tutorial/schema-extra-example.md
-  - tutorial/extra-data-types.md
-  - tutorial/cookie-params.md
-  - tutorial/header-params.md
-  - tutorial/response-model.md
-  - tutorial/extra-models.md
-  - tutorial/response-status-code.md
-  - tutorial/request-forms.md
-  - tutorial/request-files.md
-  - tutorial/request-forms-and-files.md
-  - tutorial/handling-errors.md
-  - tutorial/path-operation-configuration.md
-  - tutorial/encoder.md
-  - tutorial/body-updates.md
-  - Dependencies:
-    - tutorial/dependencies/index.md
-    - tutorial/dependencies/classes-as-dependencies.md
-    - tutorial/dependencies/sub-dependencies.md
-    - tutorial/dependencies/dependencies-in-path-operation-decorators.md
-    - tutorial/dependencies/global-dependencies.md
-    - tutorial/dependencies/dependencies-with-yield.md
-  - Security:
-    - tutorial/security/index.md
-    - tutorial/security/first-steps.md
-    - tutorial/security/get-current-user.md
-    - tutorial/security/simple-oauth2.md
-    - tutorial/security/oauth2-jwt.md
-  - tutorial/middleware.md
-  - tutorial/cors.md
-  - tutorial/sql-databases.md
-  - tutorial/bigger-applications.md
-  - tutorial/background-tasks.md
-  - tutorial/metadata.md
-  - tutorial/static-files.md
-  - tutorial/testing.md
-  - tutorial/debugging.md
-- Advanced User Guide:
-  - advanced/index.md
-  - advanced/path-operation-advanced-configuration.md
-  - advanced/additional-status-codes.md
-  - advanced/response-directly.md
-  - advanced/custom-response.md
-  - advanced/additional-responses.md
-  - advanced/response-cookies.md
-  - advanced/response-headers.md
-  - advanced/response-change-status-code.md
-  - advanced/advanced-dependencies.md
-  - Advanced Security:
-    - advanced/security/index.md
-    - advanced/security/oauth2-scopes.md
-    - advanced/security/http-basic-auth.md
-  - advanced/using-request-directly.md
-  - advanced/dataclasses.md
-  - advanced/middleware.md
-  - advanced/sql-databases-peewee.md
-  - advanced/async-sql-databases.md
-  - advanced/nosql-databases.md
-  - advanced/sub-applications.md
-  - advanced/behind-a-proxy.md
-  - advanced/templates.md
-  - advanced/graphql.md
-  - advanced/websockets.md
-  - advanced/events.md
-  - advanced/custom-request-and-route.md
-  - advanced/testing-websockets.md
-  - advanced/testing-events.md
-  - advanced/testing-dependencies.md
-  - advanced/testing-database.md
-  - advanced/async-tests.md
-  - advanced/settings.md
-  - advanced/conditional-openapi.md
-  - advanced/extending-openapi.md
-  - advanced/openapi-callbacks.md
-  - advanced/openapi-webhooks.md
-  - advanced/wsgi.md
-  - advanced/generate-clients.md
-- async.md
-- Deployment:
-  - deployment/index.md
-  - deployment/versions.md
-  - deployment/https.md
-  - deployment/manually.md
-  - deployment/concepts.md
-  - deployment/deta.md
-  - deployment/server-workers.md
-  - deployment/docker.md
-- project-generation.md
-- alternatives.md
-- history-design-future.md
-- external-links.md
-- benchmarks.md
-- help-fastapi.md
-- newsletter.md
-- contributing.md
+- Resources:
+  - resources/index.md
+  - project-generation.md
+  - external-links.md
+  - newsletter.md
+- About:
+  - about/index.md
+  - alternatives.md
+  - history-design-future.md
+  - benchmarks.md
+- Help:
+  - help/index.md
+  - help-fastapi.md
+  - contributing.md
 - release-notes.md
 markdown_extensions:
   toc:
@@ -176,9 +229,9 @@ markdown_extensions:
     guess_lang: false
   mdx_include:
     base_path: docs
-  admonition:
-  codehilite:
-  extra:
+  admonition: null
+  codehilite: null
+  extra: null
   pymdownx.superfences:
     custom_fences:
     - name: mermaid
@@ -186,8 +239,8 @@ markdown_extensions:
       format: !!python/name:pymdownx.superfences.fence_code_format ''
   pymdownx.tabbed:
     alternate_style: true
-  attr_list:
-  md_in_html:
+  attr_list: null
+  md_in_html: null
 extra:
   analytics:
     provider: google
@@ -236,6 +289,14 @@ extra:
     name: ru - русский язык
   - link: /tr/
     name: tr - Türkçe
+  - link: /uk/
+    name: uk
+  - link: /ur/
+    name: ur
+  - link: /vi/
+    name: vi - Tiếng Việt
+  - link: /yo/
+    name: yo - Yorùbá
   - link: /zh/
     name: zh - 汉语
 extra_css:
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 4608880f2..4c7f19fd4 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -34,6 +34,24 @@
         <img class="sponsor-image" src="/img/sponsors/platform-sh-banner.png" />
       </a>
     </div>
+    <div class="item">
+      <a title="Fern | SDKs and API docs" style="display: block; position: relative;" href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=top-banner" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/fern-banner.svg" />
+      </a>
+    </div>
+    <div class="item">
+      <a title="Deploy FastAPI on AWS with a few clicks" style="display: block; position: relative;" href="https://www.porter.run" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/porter-banner.png" />
+      </a>
+    </div>
+    <div class="item">
+      <a title="Automate FastAPI documentation generation with Bump.sh" style="display: block; position: relative;" href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/bump-sh-banner.svg" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}
diff --git a/docs/es/docs/features.md b/docs/es/docs/features.md
index 5d6b6509a..d05c4f73e 100644
--- a/docs/es/docs/features.md
+++ b/docs/es/docs/features.md
@@ -25,7 +25,7 @@ Documentación interactiva de la API e interfaces web de exploración. Hay múlt
 
 ### Simplemente Python moderno
 
-Todo está basado en las declaraciones de tipo de **Python 3.6** estándar (gracias a Pydantic). No necesitas aprender una sintáxis nueva, solo Python moderno.
+Todo está basado en las declaraciones de tipo de **Python 3.8** estándar (gracias a Pydantic). No necesitas aprender una sintáxis nueva, solo Python moderno.
 
 Si necesitas un repaso de 2 minutos de cómo usar los tipos de Python (así no uses FastAPI) prueba el tutorial corto: [Python Types](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/es/docs/index.md b/docs/es/docs/index.md
index 5b75880c0..30a575577 100644
--- a/docs/es/docs/index.md
+++ b/docs/es/docs/index.md
@@ -23,7 +23,7 @@
 **Código Fuente**: <a href="https://github.com/tiangolo/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
 
 ---
-FastAPI es un web framework moderno y rápido (de alto rendimiento) para construir APIs con Python 3.6+ basado en las anotaciones de tipos estándar de Python.
+FastAPI es un web framework moderno y rápido (de alto rendimiento) para construir APIs con Python 3.8+ basado en las anotaciones de tipos estándar de Python.
 
 Sus características principales son:
 
@@ -106,7 +106,7 @@ Si estás construyendo un app de <abbr title="Interfaz de línea de comandos en
 
 ## Requisitos
 
-Python 3.7+
+Python 3.8+
 
 FastAPI está sobre los hombros de gigantes:
 
@@ -319,7 +319,7 @@ Lo haces con tipos modernos estándar de Python.
 
 No tienes que aprender una sintáxis nueva, los métodos o clases de una library específica, etc.
 
-Solo **Python 3.6+** estándar.
+Solo **Python 3.8+** estándar.
 
 Por ejemplo, para un `int`:
 
diff --git a/docs/fr/docs/advanced/path-operation-advanced-configuration.md b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
index ace9f19f9..7ded97ce1 100644
--- a/docs/fr/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
@@ -66,7 +66,7 @@ Il y a un chapitre entier ici dans la documentation à ce sujet, vous pouvez le
 Lorsque vous déclarez un *chemin* dans votre application, **FastAPI** génère automatiquement les métadonnées concernant ce *chemin* à inclure dans le schéma OpenAPI.
 
 !!! note "Détails techniques"
-    La spécification OpenAPI appelle ces métaonnées des <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Objets d'opération</a>.
+    La spécification OpenAPI appelle ces métadonnées des <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Objets d'opération</a>.
 
 Il contient toutes les informations sur le *chemin* et est utilisé pour générer automatiquement la documentation.
 
diff --git a/docs/fr/docs/alternatives.md b/docs/fr/docs/alternatives.md
index ee20438c3..8e58a3dfa 100644
--- a/docs/fr/docs/alternatives.md
+++ b/docs/fr/docs/alternatives.md
@@ -387,7 +387,7 @@ Gérer toute la validation des données, leur sérialisation et la documentation
 
 ### <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a>
 
-Starlette est un framework/toolkit léger <abbr title="Le nouveau standard pour construire des applications web assynchrones en Python">ASGI</abbr>, qui est idéal pour construire des services asyncio performants.
+Starlette est un framework/toolkit léger <abbr title="Le nouveau standard pour construire des applications web asynchrones en Python">ASGI</abbr>, qui est idéal pour construire des services asyncio performants.
 
 Il est très simple et intuitif. Il est conçu pour être facilement extensible et avoir des composants modulaires.
 
diff --git a/docs/fr/docs/async.md b/docs/fr/docs/async.md
index db88c4663..af4d6ca06 100644
--- a/docs/fr/docs/async.md
+++ b/docs/fr/docs/async.md
@@ -250,7 +250,7 @@ Par exemple :
 
 ### Concurrence + Parallélisme : Web + Machine Learning
 
-Avec **FastAPI** vous pouvez bénéficier de la concurrence qui est très courante en developement web (c'est l'attrait principal de NodeJS).
+Avec **FastAPI** vous pouvez bénéficier de la concurrence qui est très courante en développement web (c'est l'attrait principal de NodeJS).
 
 Mais vous pouvez aussi profiter du parallélisme et multiprocessing afin de gérer des charges **CPU bound** qui sont récurrentes dans les systèmes de *Machine Learning*.
 
diff --git a/docs/fr/docs/benchmarks.md b/docs/fr/docs/benchmarks.md
new file mode 100644
index 000000000..d33c263a2
--- /dev/null
+++ b/docs/fr/docs/benchmarks.md
@@ -0,0 +1,34 @@
+# Test de performance
+
+Les tests de performance de TechEmpower montrent que les applications **FastAPI** tournant sous Uvicorn comme <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">étant l'un des frameworks Python les plus rapides disponibles</a>, seulement inférieur à Starlette et Uvicorn (tous deux utilisés au cœur de FastAPI). (*)
+
+Mais en prêtant attention aux tests de performance et aux comparaisons, il faut tenir compte de ce qu'il suit.
+
+## Tests de performance et rapidité
+
+Lorsque vous vérifiez les tests de performance, il est commun de voir plusieurs outils de différents types comparés comme équivalents.
+
+En particulier, on voit Uvicorn, Starlette et FastAPI comparés (parmi de nombreux autres outils).
+
+Plus le problème résolu par un outil est simple, mieux seront les performances obtenues. Et la plupart des tests de performance ne prennent pas en compte les fonctionnalités additionnelles fournies par les outils.
+
+La hiérarchie est la suivante :
+
+* **Uvicorn** : un serveur ASGI
+    * **Starlette** : (utilise Uvicorn) un micro-framework web
+        * **FastAPI**: (utilise Starlette) un micro-framework pour API disposant de fonctionnalités additionnelles pour la création d'API, avec la validation des données, etc.
+
+* **Uvicorn** :
+    * A les meilleures performances, étant donné qu'il n'a pas beaucoup de code mis-à-part le serveur en lui-même.
+    * On n'écrit pas une application avec uniquement Uvicorn. Cela signifie que le code devrait inclure plus ou moins, au minimum, tout le code offert par Starlette (ou **FastAPI**). Et si on fait cela, l'application finale apportera les mêmes complications que si on avait utilisé un framework et que l'on avait minimisé la quantité de code et de bugs.
+    * Si on compare Uvicorn, il faut le comparer à d'autre applications de serveurs comme Daphne, Hypercorn, uWSGI, etc.
+* **Starlette** :
+    * A les seconde meilleures performances après Uvicorn. Starlette utilise en réalité Uvicorn. De ce fait, il ne peut qu’être plus "lent" qu'Uvicorn car il requiert l'exécution de plus de code.
+    * Cependant il nous apporte les outils pour construire une application web simple, avec un routage basé sur des chemins, etc.
+    * Si on compare Starlette, il faut le comparer à d'autres frameworks web (ou micorframework) comme Sanic, Flask, Django, etc.
+* **FastAPI** :
+    * Comme Starlette, FastAPI utilise Uvicorn et ne peut donc pas être plus rapide que ce dernier.
+    * FastAPI apporte des fonctionnalités supplémentaires à Starlette. Des fonctionnalités qui sont nécessaires presque systématiquement lors de la création d'une API, comme la validation des données, la sérialisation. En utilisant FastAPI, on obtient une documentation automatiquement (qui ne requiert aucune manipulation pour être mise en place).
+    * Si on n'utilisait pas FastAPI mais directement Starlette (ou un outil équivalent comme Sanic, Flask, Responder, etc) il faudrait implémenter la validation des données et la sérialisation par nous-même. Le résultat serait donc le même dans les deux cas mais du travail supplémentaire serait à réaliser avec Starlette, surtout en considérant que la validation des données et la sérialisation représentent la plus grande quantité de code à écrire dans une application.
+    * De ce fait, en utilisant FastAPI on minimise le temps de développement, les bugs, le nombre de lignes de code, et on obtient les mêmes performances (si ce n'est de meilleurs performances) que l'on aurait pu avoir sans ce framework (en ayant à implémenter de nombreuses fonctionnalités importantes par nous-mêmes).
+    * Si on compare FastAPI, il faut le comparer à d'autres frameworks web (ou ensemble d'outils) qui fournissent la validation des données, la sérialisation et la documentation, comme Flask-apispec, NestJS, Molten, etc.
diff --git a/docs/fr/docs/contributing.md b/docs/fr/docs/contributing.md
new file mode 100644
index 000000000..8292f14bb
--- /dev/null
+++ b/docs/fr/docs/contributing.md
@@ -0,0 +1,501 @@
+# Développement - Contribuer
+
+Tout d'abord, vous voudrez peut-être voir les moyens de base pour [aider FastAPI et obtenir de l'aide](help-fastapi.md){.internal-link target=_blank}.
+
+## Développement
+
+Si vous avez déjà cloné le dépôt et que vous savez que vous devez vous plonger dans le code, voici quelques directives pour mettre en place votre environnement.
+
+### Environnement virtuel avec `venv`
+
+Vous pouvez créer un environnement virtuel dans un répertoire en utilisant le module `venv` de Python :
+
+<div class="termy">
+
+```console
+$ python -m venv env
+```
+
+</div>
+
+Cela va créer un répertoire `./env/` avec les binaires Python et vous pourrez alors installer des paquets pour cet environnement isolé.
+
+### Activer l'environnement
+
+Activez le nouvel environnement avec :
+
+=== "Linux, macOS"
+
+    <div class="termy">
+
+    ```console
+    $ source ./env/bin/activate
+    ```
+
+    </div>
+
+=== "Windows PowerShell"
+
+    <div class="termy">
+
+    ```console
+    $ .\env\Scripts\Activate.ps1
+    ```
+
+    </div>
+
+=== "Windows Bash"
+
+    Ou si vous utilisez Bash pour Windows (par exemple <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+    <div class="termy">
+
+    ```console
+    $ source ./env/Scripts/activate
+    ```
+
+    </div>
+
+Pour vérifier que cela a fonctionné, utilisez :
+
+=== "Linux, macOS, Windows Bash"
+
+    <div class="termy">
+
+    ```console
+    $ which pip
+
+    some/directory/fastapi/env/bin/pip
+    ```
+
+    </div>
+
+=== "Windows PowerShell"
+
+    <div class="termy">
+
+    ```console
+    $ Get-Command pip
+
+    some/directory/fastapi/env/bin/pip
+    ```
+
+    </div>
+
+Si celui-ci montre le binaire `pip` à `env/bin/pip`, alors ça a fonctionné. 🎉
+
+
+
+!!! tip
+    Chaque fois que vous installez un nouveau paquet avec `pip` sous cet environnement, activez à nouveau l'environnement.
+
+    Cela permet de s'assurer que si vous utilisez un programme terminal installé par ce paquet (comme `flit`), vous utilisez celui de votre environnement local et pas un autre qui pourrait être installé globalement.
+
+### Flit
+
+**FastAPI** utilise <a href="https://flit.readthedocs.io/en/latest/index.html" class="external-link" target="_blank">Flit</a> pour build, packager et publier le projet.
+
+Après avoir activé l'environnement comme décrit ci-dessus, installez `flit` :
+
+<div class="termy">
+
+```console
+$ pip install flit
+
+---> 100%
+```
+
+</div>
+
+Réactivez maintenant l'environnement pour vous assurer que vous utilisez le "flit" que vous venez d'installer (et non un environnement global).
+
+Et maintenant, utilisez `flit` pour installer les dépendances de développement :
+
+=== "Linux, macOS"
+
+    <div class="termy">
+
+    ```console
+    $ flit install --deps develop --symlink
+
+    ---> 100%
+    ```
+
+    </div>
+
+=== "Windows"
+
+    Si vous êtes sous Windows, utilisez `--pth-file` au lieu de `--symlink` :
+
+    <div class="termy">
+
+    ```console
+    $ flit install --deps develop --pth-file
+
+    ---> 100%
+    ```
+
+    </div>
+
+Il installera toutes les dépendances et votre FastAPI local dans votre environnement local.
+
+#### Utiliser votre FastAPI local
+
+Si vous créez un fichier Python qui importe et utilise FastAPI, et que vous l'exécutez avec le Python de votre environnement local, il utilisera votre code source FastAPI local.
+
+Et si vous mettez à jour le code source local de FastAPI, tel qu'il est installé avec `--symlink` (ou `--pth-file` sous Windows), lorsque vous exécutez à nouveau ce fichier Python, il utilisera la nouvelle version de FastAPI que vous venez d'éditer.
+
+De cette façon, vous n'avez pas à "installer" votre version locale pour pouvoir tester chaque changement.
+
+### Formatage
+
+Il existe un script que vous pouvez exécuter qui formatera et nettoiera tout votre code :
+
+<div class="termy">
+
+```console
+$ bash scripts/format.sh
+```
+
+</div>
+
+Il effectuera également un tri automatique de touts vos imports.
+
+Pour qu'il puisse les trier correctement, vous devez avoir FastAPI installé localement dans votre environnement, avec la commande dans la section ci-dessus en utilisant `--symlink` (ou `--pth-file` sous Windows).
+
+### Formatage des imports
+
+Il existe un autre script qui permet de formater touts les imports et de s'assurer que vous n'avez pas d'imports inutilisés :
+
+<div class="termy">
+
+```console
+$ bash scripts/format-imports.sh
+```
+
+</div>
+
+Comme il exécute une commande après l'autre et modifie et inverse de nombreux fichiers, il prend un peu plus de temps à s'exécuter, il pourrait donc être plus facile d'utiliser fréquemment `scripts/format.sh` et `scripts/format-imports.sh` seulement avant de commit.
+
+## Documentation
+
+Tout d'abord, assurez-vous que vous configurez votre environnement comme décrit ci-dessus, qui installera toutes les exigences.
+
+La documentation utilise <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
+
+Et il y a des outils/scripts supplémentaires en place pour gérer les traductions dans `./scripts/docs.py`.
+
+!!! tip
+    Vous n'avez pas besoin de voir le code dans `./scripts/docs.py`, vous l'utilisez simplement dans la ligne de commande.
+
+Toute la documentation est au format Markdown dans le répertoire `./docs/fr/`.
+
+De nombreux tutoriels comportent des blocs de code.
+
+Dans la plupart des cas, ces blocs de code sont de véritables applications complètes qui peuvent être exécutées telles quelles.
+
+En fait, ces blocs de code ne sont pas écrits à l'intérieur du Markdown, ce sont des fichiers Python dans le répertoire `./docs_src/`.
+
+Et ces fichiers Python sont inclus/injectés dans la documentation lors de la génération du site.
+
+### Documentation pour les tests
+
+La plupart des tests sont en fait effectués par rapport aux exemples de fichiers sources dans la documentation.
+
+Cela permet de s'assurer que :
+
+* La documentation est à jour.
+* Les exemples de documentation peuvent être exécutés tels quels.
+* La plupart des fonctionnalités sont couvertes par la documentation, assurées par la couverture des tests.
+
+Au cours du développement local, un script build le site et vérifie les changements éventuels, puis il est rechargé en direct :
+
+<div class="termy">
+
+```console
+$ python ./scripts/docs.py live
+
+<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
+<span style="color: green;">[INFO]</span> Start watching changes
+<span style="color: green;">[INFO]</span> Start detecting changes
+```
+
+</div>
+
+Il servira la documentation sur `http://127.0.0.1:8008`.
+
+De cette façon, vous pouvez modifier la documentation/les fichiers sources et voir les changements en direct.
+
+#### Typer CLI (facultatif)
+
+Les instructions ici vous montrent comment utiliser le script à `./scripts/docs.py` avec le programme `python` directement.
+
+Mais vous pouvez également utiliser <a href="https://typer.tiangolo.com/typer-cli/" class="external-link" target="_blank">Typer CLI</a>, et vous obtiendrez l'auto-complétion dans votre terminal pour les commandes après l'achèvement de l'installation.
+
+Si vous installez Typer CLI, vous pouvez installer la complétion avec :
+
+<div class="termy">
+
+```console
+$ typer --install-completion
+
+zsh completion installed in /home/user/.bashrc.
+Completion will take effect once you restart the terminal.
+```
+
+</div>
+
+### Apps et documentation en même temps
+
+Si vous exécutez les exemples avec, par exemple :
+
+<div class="termy">
+
+```console
+$ uvicorn tutorial001:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Comme Uvicorn utilisera par défaut le port `8000`, la documentation sur le port `8008` n'entrera pas en conflit.
+
+### Traductions
+
+L'aide aux traductions est TRÈS appréciée ! Et cela ne peut se faire sans l'aide de la communauté. 🌎 🚀
+
+Voici les étapes à suivre pour aider à la traduction.
+
+#### Conseils et lignes directrices
+
+* Vérifiez les <a href="https://github.com/tiangolo/fastapi/pulls" class="external-link" target="_blank">pull requests existantes</a> pour votre langue et ajouter des reviews demandant des changements ou les approuvant.
+
+!!! tip
+    Vous pouvez <a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request" class="external-link" target="_blank">ajouter des commentaires avec des suggestions de changement</a> aux pull requests existantes.
+
+    Consultez les documents concernant <a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews" class="external-link" target="_blank">l'ajout d'un review de pull request</a> pour l'approuver ou demander des modifications.
+
+* Vérifiez dans <a href="https://github.com/tiangolo/fastapi/issues" class="external-link" target="_blank">issues</a> pour voir s'il y a une personne qui coordonne les traductions pour votre langue.
+
+* Ajoutez une seule pull request par page traduite. Il sera ainsi beaucoup plus facile pour les autres de l'examiner.
+
+Pour les langues que je ne parle pas, je vais attendre plusieurs autres reviews de la traduction avant de merge.
+
+* Vous pouvez également vérifier s'il existe des traductions pour votre langue et y ajouter une review, ce qui m'aidera à savoir si la traduction est correcte et je pourrai la fusionner.
+
+* Utilisez les mêmes exemples en Python et ne traduisez que le texte des documents. Vous n'avez pas besoin de changer quoi que ce soit pour que cela fonctionne.
+
+* Utilisez les mêmes images, noms de fichiers et liens. Vous n'avez pas besoin de changer quoi que ce soit pour que cela fonctionne.
+
+* Pour vérifier le code à 2 lettres de la langue que vous souhaitez traduire, vous pouvez utiliser le tableau <a href="https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes" class="external-link" target="_blank">Liste des codes ISO 639-1</a>.
+
+#### Langue existante
+
+Disons que vous voulez traduire une page pour une langue qui a déjà des traductions pour certaines pages, comme l'espagnol.
+
+Dans le cas de l'espagnol, le code à deux lettres est `es`. Ainsi, le répertoire des traductions espagnoles se trouve à l'adresse `docs/es/`.
+
+!!! tip
+    La langue principale ("officielle") est l'anglais, qui se trouve à l'adresse "docs/en/".
+
+Maintenant, lancez le serveur en live pour les documents en espagnol :
+
+<div class="termy">
+
+```console
+// Use the command "live" and pass the language code as a CLI argument
+$ python ./scripts/docs.py live es
+
+<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
+<span style="color: green;">[INFO]</span> Start watching changes
+<span style="color: green;">[INFO]</span> Start detecting changes
+```
+
+</div>
+
+Vous pouvez maintenant aller sur <a href="http://127.0.0.1:8008" class="external-link" target="_blank">http://127.0.0.1:8008</a> et voir vos changements en direct.
+
+Si vous regardez le site web FastAPI docs, vous verrez que chaque langue a toutes les pages. Mais certaines pages ne sont pas traduites et sont accompagnées d'une notification concernant la traduction manquante.
+
+Mais si vous le gérez localement de cette manière, vous ne verrez que les pages déjà traduites.
+
+Disons maintenant que vous voulez ajouter une traduction pour la section [Features](features.md){.internal-link target=_blank}.
+
+* Copiez le fichier à :
+
+```
+docs/en/docs/features.md
+```
+
+* Collez-le exactement au même endroit mais pour la langue que vous voulez traduire, par exemple :
+
+```
+docs/es/docs/features.md
+```
+
+!!! tip
+    Notez que le seul changement dans le chemin et le nom du fichier est le code de langue, qui passe de `en` à `es`.
+
+* Ouvrez maintenant le fichier de configuration de MkDocs pour l'anglais à
+
+```
+docs/en/docs/mkdocs.yml
+```
+
+* Trouvez l'endroit où cette `docs/features.md` se trouve dans le fichier de configuration. Quelque part comme :
+
+```YAML hl_lines="8"
+site_name: FastAPI
+# More stuff
+nav:
+- FastAPI: index.md
+- Languages:
+  - en: /
+  - es: /es/
+- features.md
+```
+
+* Ouvrez le fichier de configuration MkDocs pour la langue que vous éditez, par exemple :
+
+```
+docs/es/docs/mkdocs.yml
+```
+
+* Ajoutez-le à l'endroit exact où il se trouvait pour l'anglais, par exemple :
+
+```YAML hl_lines="8"
+site_name: FastAPI
+# More stuff
+nav:
+- FastAPI: index.md
+- Languages:
+  - en: /
+  - es: /es/
+- features.md
+```
+
+Assurez-vous que s'il y a d'autres entrées, la nouvelle entrée avec votre traduction est exactement dans le même ordre que dans la version anglaise.
+
+Si vous allez sur votre navigateur, vous verrez que maintenant les documents montrent votre nouvelle section. 🎉
+
+Vous pouvez maintenant tout traduire et voir à quoi cela ressemble au fur et à mesure que vous enregistrez le fichier.
+
+#### Nouvelle langue
+
+Disons que vous voulez ajouter des traductions pour une langue qui n'est pas encore traduite, pas même quelques pages.
+
+Disons que vous voulez ajouter des traductions pour le Créole, et que ce n'est pas encore dans les documents.
+
+En vérifiant le lien ci-dessus, le code pour "Créole" est `ht`.
+
+L'étape suivante consiste à exécuter le script pour générer un nouveau répertoire de traduction :
+
+<div class="termy">
+
+```console
+// Use the command new-lang, pass the language code as a CLI argument
+$ python ./scripts/docs.py new-lang ht
+
+Successfully initialized: docs/ht
+Updating ht
+Updating en
+```
+
+</div>
+
+Vous pouvez maintenant vérifier dans votre éditeur de code le répertoire nouvellement créé `docs/ht/`.
+
+!!! tip
+    Créez une première demande d'extraction à l'aide de cette fonction, afin de configurer la nouvelle langue avant d'ajouter des traductions.
+
+    Ainsi, d'autres personnes peuvent vous aider à rédiger d'autres pages pendant que vous travaillez sur la première. 🚀
+
+Commencez par traduire la page principale, `docs/ht/index.md`.
+
+Vous pouvez ensuite continuer avec les instructions précédentes, pour une "langue existante".
+
+##### Nouvelle langue non prise en charge
+
+Si, lors de l'exécution du script du serveur en direct, vous obtenez une erreur indiquant que la langue n'est pas prise en charge, quelque chose comme :
+
+```
+ raise TemplateNotFound(template)
+jinja2.exceptions.TemplateNotFound: partials/language/xx.html
+```
+
+Cela signifie que le thème ne supporte pas cette langue (dans ce cas, avec un faux code de 2 lettres de `xx`).
+
+Mais ne vous inquiétez pas, vous pouvez définir la langue du thème en anglais et ensuite traduire le contenu des documents.
+
+Si vous avez besoin de faire cela, modifiez le fichier `mkdocs.yml` pour votre nouvelle langue, il aura quelque chose comme :
+
+```YAML hl_lines="5"
+site_name: FastAPI
+# More stuff
+theme:
+  # More stuff
+  language: xx
+```
+
+Changez cette langue de `xx` (de votre code de langue) à `fr`.
+
+Vous pouvez ensuite relancer le serveur live.
+
+#### Prévisualisez le résultat
+
+Lorsque vous utilisez le script à `./scripts/docs.py` avec la commande `live`, il n'affiche que les fichiers et les traductions disponibles pour la langue courante.
+
+Mais une fois que vous avez terminé, vous pouvez tester le tout comme il le ferait en ligne.
+
+Pour ce faire, il faut d'abord construire tous les documents :
+
+<div class="termy">
+
+```console
+// Use the command "build-all", this will take a bit
+$ python ./scripts/docs.py build-all
+
+Updating es
+Updating en
+Building docs for: en
+Building docs for: es
+Successfully built docs for: es
+Copying en index.md to README.md
+```
+
+</div>
+
+Cela génère tous les documents à `./docs_build/` pour chaque langue. Cela inclut l'ajout de tout fichier dont la traduction est manquante, avec une note disant que "ce fichier n'a pas encore de traduction". Mais vous n'avez rien à faire avec ce répertoire.
+
+Ensuite, il construit tous ces sites MkDocs indépendants pour chaque langue, les combine, et génère le résultat final à `./site/`.
+
+Ensuite, vous pouvez servir cela avec le commandement `serve`:
+
+<div class="termy">
+
+```console
+// Use the command "serve" after running "build-all"
+$ python ./scripts/docs.py serve
+
+Warning: this is a very simple server. For development, use mkdocs serve instead.
+This is here only to preview a site with translations already built.
+Make sure you run the build-all command first.
+Serving at: http://127.0.0.1:8008
+```
+
+</div>
+
+## Tests
+
+Il existe un script que vous pouvez exécuter localement pour tester tout le code et générer des rapports de couverture en HTML :
+
+<div class="termy">
+
+```console
+$ bash scripts/test-cov-html.sh
+```
+
+</div>
+
+Cette commande génère un répertoire `./htmlcov/`, si vous ouvrez le fichier `./htmlcov/index.html` dans votre navigateur, vous pouvez explorer interactivement les régions de code qui sont couvertes par les tests, et remarquer s'il y a une région manquante.
diff --git a/docs/fr/docs/deployment/deta.md b/docs/fr/docs/deployment/deta.md
deleted file mode 100644
index cceb7b058..000000000
--- a/docs/fr/docs/deployment/deta.md
+++ /dev/null
@@ -1,245 +0,0 @@
-# Déployer FastAPI sur Deta
-
-Dans cette section, vous apprendrez à déployer facilement une application **FastAPI** sur <a href="https://www.deta.
-sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> en utilisant le plan tarifaire gratuit. 🎁
-
-Cela vous prendra environ **10 minutes**.
-
-!!! info
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> sponsorise **FastAPI**. 🎉
-
-## Une application **FastAPI** de base
-
-* Créez un répertoire pour votre application, par exemple `./fastapideta/` et déplacez-vous dedans.
-
-### Le code FastAPI
-
-* Créer un fichier `main.py` avec :
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Dépendances
-
-Maintenant, dans le même répertoire, créez un fichier `requirements.txt` avec :
-
-```text
-fastapi
-```
-
-!!! tip "Astuce"
-    Il n'est pas nécessaire d'installer Uvicorn pour déployer sur Deta, bien qu'il soit probablement souhaitable de l'installer localement pour tester votre application.
-
-### Structure du répertoire
-
-Vous aurez maintenant un répertoire `./fastapideta/` avec deux fichiers :
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Créer un compte gratuit sur Deta
-
-Créez maintenant un <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">compte gratuit
-sur Deta</a>, vous avez juste besoin d'une adresse email et d'un mot de passe.
-
-Vous n'avez même pas besoin d'une carte de crédit.
-
-## Installer le CLI (Interface en Ligne de Commande)
-
-Une fois que vous avez votre compte, installez le  <abbr title="Command Line Interface application">CLI</abbr> de Deta :
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-Après l'avoir installé, ouvrez un nouveau terminal afin que la nouvelle installation soit détectée.
-
-Dans un nouveau terminal, confirmez qu'il a été correctement installé avec :
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip "Astuce"
-    Si vous rencontrez des problèmes pour installer le CLI, consultez la <a href="https://docs.deta. sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">documentation officielle de Deta (en anglais)</a>.
-
-## Connexion avec le CLI
-
-Maintenant, connectez-vous à Deta depuis le CLI avec :
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-Cela ouvrira un navigateur web et permettra une authentification automatique.
-
-## Déployer avec Deta
-
-Ensuite, déployez votre application avec le CLI de Deta :
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-Vous verrez un message JSON similaire à :
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip "Astuce"
-    Votre déploiement aura une URL `"endpoint"` différente.
-
-## Vérifiez
-
-Maintenant, dans votre navigateur ouvrez votre URL `endpoint`. Dans l'exemple ci-dessus, c'était
-`https://qltnci.deta.dev`, mais la vôtre sera différente.
-
-Vous verrez la réponse JSON de votre application FastAPI :
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-Et maintenant naviguez vers `/docs` dans votre API, dans l'exemple ci-dessus ce serait `https://qltnci.deta.dev/docs`.
-
-Vous verrez votre documentation comme suit :
-
-<img src="/img/deployment/deta/image01.png">
-
-## Activer l'accès public
-
-Par défaut, Deta va gérer l'authentification en utilisant des cookies pour votre compte.
-
-Mais une fois que vous êtes prêt, vous pouvez le rendre public avec :
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-Maintenant, vous pouvez partager cette URL avec n'importe qui et ils seront en mesure d'accéder à votre API. 🚀
-
-## HTTPS
-
-Félicitations ! Vous avez déployé votre application FastAPI sur Deta ! 🎉 🍰
-
-Remarquez également que Deta gère correctement HTTPS pour vous, vous n'avez donc pas à vous en occuper et pouvez être sûr que vos clients auront une connexion cryptée sécurisée. ✅ 🔒
-
-## Vérifiez le Visor
-
-À partir de l'interface graphique de votre documentation (dans une URL telle que `https://qltnci.deta.dev/docs`)
-envoyez une requête à votre *opération de chemin* `/items/{item_id}`.
-
-Par exemple avec l'ID `5`.
-
-Allez maintenant sur <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.
-
-Vous verrez qu'il y a une section à gauche appelée <abbr title="ça vient de Micro(server)">"Micros"</abbr> avec chacune de vos applications.
-
-Vous verrez un onglet avec "Details", et aussi un onglet "Visor", allez à l'onglet "Visor".
-
-Vous pouvez y consulter les requêtes récentes envoyées à votre application.
-
-Vous pouvez également les modifier et les relancer.
-
-<img src="/img/deployment/deta/image02.png">
-
-## En savoir plus
-
-À un moment donné, vous voudrez probablement stocker certaines données pour votre application d'une manière qui
-persiste dans le temps. Pour cela, vous pouvez utiliser <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a>, il dispose également d'un généreux **plan gratuit**.
-
-Vous pouvez également en lire plus dans la <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">documentation Deta</a>.
diff --git a/docs/fr/docs/external-links.md b/docs/fr/docs/external-links.md
index 002e6d2b2..37b8c5b13 100644
--- a/docs/fr/docs/external-links.md
+++ b/docs/fr/docs/external-links.md
@@ -9,70 +9,21 @@ Voici une liste incomplète de certains d'entre eux.
 !!! tip "Astuce"
     Si vous avez un article, projet, outil, ou quoi que ce soit lié à **FastAPI** qui n'est actuellement pas listé ici, créez une <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request l'ajoutant</a>.
 
-## Articles
+{% for section_name, section_content in external_links.items() %}
 
-### Anglais
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
+
+### {{ 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>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Japonais
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Vietnamien
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Russe
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Allemand
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Podcasts
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Conférences
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
 
 ## Projets
 
diff --git a/docs/fr/docs/features.md b/docs/fr/docs/features.md
index dcc0e39ed..0c1f6269a 100644
--- a/docs/fr/docs/features.md
+++ b/docs/fr/docs/features.md
@@ -25,7 +25,7 @@ Documentation d'API interactive et interface web d'exploration. Comme le framewo
 
 ### Faite en python moderne
 
-Tout est basé sur la déclaration de type standard de **Python 3.6** (grâce à Pydantic). Pas de nouvelles syntaxes à apprendre. Juste du Python standard et moderne.
+Tout est basé sur la déclaration de type standard de **Python 3.8** (grâce à Pydantic). Pas de nouvelles syntaxes à apprendre. Juste du Python standard et moderne.
 
 Si vous souhaitez un rappel de 2 minutes sur l'utilisation des types en Python (même si vous ne comptez pas utiliser FastAPI), jetez un oeil au tutoriel suivant: [Python Types](python-types.md){.internal-link target=_blank}.
 
@@ -71,9 +71,9 @@ my_second_user: User = User(**second_user_data)
 
 Tout le framework a été conçu pour être facile et intuitif d'utilisation, toutes les décisions de design ont été testées sur de nombreux éditeurs avant même de commencer le développement final afin d'assurer la meilleure expérience de développement possible.
 
-Dans le dernier sondage effectué auprès de développeurs python il était clair que <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">la fonctionnalité la plus utilisée est "l'autocomplètion"</a>.
+Dans le dernier sondage effectué auprès de développeurs python il était clair que <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">la fonctionnalité la plus utilisée est "l’autocomplétion"</a>.
 
-Tout le framwork **FastAPI** a été conçu avec cela en tête. L'autocomplétion fonctionne partout.
+Tout le framework **FastAPI** a été conçu avec cela en tête. L'autocomplétion fonctionne partout.
 
 Vous devrez rarement revenir à la documentation.
 
@@ -136,7 +136,7 @@ FastAPI contient un système simple mais extrêmement puissant d'<abbr title='au
 
 * Même les dépendances peuvent avoir des dépendances, créant une hiérarchie ou un **"graph" de dépendances**
 * Tout est **automatiquement géré** par le framework
-* Toutes les dépendances peuvent éxiger des données d'une requêtes et **Augmenter les contraintes d'un path operation** et de la documentation automatique.
+* Toutes les dépendances peuvent exiger des données d'une requêtes et **Augmenter les contraintes d'un path operation** et de la documentation automatique.
 * **Validation automatique** même pour les paramètres de *path operation* définis dans les dépendances.
 * Supporte les systèmes d'authentification d'utilisateurs complexes, les **connexions de base de données**, etc.
 * **Aucun compromis** avec les bases de données, les frontends, etc. Mais une intégration facile avec n'importe lequel d'entre eux.
@@ -157,11 +157,11 @@ Tout intégration est conçue pour être si simple à utiliser (avec des dépend
 
 **FastAPI** est complètement compatible (et basé sur) <a href="https://www.starlette.io/" class="external-link" target="_blank"><strong>Starlette</strong></a>. Le code utilisant Starlette que vous ajouterez fonctionnera donc aussi.
 
-En fait, `FastAPI` est un sous compposant de `Starlette`. Donc, si vous savez déjà comment utiliser Starlette, la plupart des fonctionnalités fonctionneront de la même manière.
+En fait, `FastAPI` est un sous composant de `Starlette`. Donc, si vous savez déjà comment utiliser Starlette, la plupart des fonctionnalités fonctionneront de la même manière.
 
 Avec **FastAPI** vous aurez toutes les fonctionnalités de **Starlette** (FastAPI est juste Starlette sous stéroïdes):
 
-* Des performances vraiments impressionnantes. C'est l'<a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">un des framework Python les plus rapide, à égalité avec **NodeJS** et **GO**</a>.
+* Des performances vraiment impressionnantes. C'est l'<a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">un des framework Python les plus rapide, à égalité avec **NodeJS** et **GO**</a>.
 * Le support des **WebSockets**.
 * Le support de **GraphQL**.
 * Les <abbr title="En anglais: In-process background tasks">tâches d'arrière-plan.</abbr>
@@ -180,7 +180,7 @@ Inclus des librairies externes basées, aussi, sur Pydantic, servent d'<abbr tit
 
 Cela signifie aussi que, dans la plupart des cas, vous pouvez fournir l'objet reçu d'une requête **directement à la base de données**, comme tout est validé automatiquement.
 
-Inversément, dans la plupart des cas vous pourrez juste envoyer l'objet récupéré de la base de données **directement au client**
+Inversement, dans la plupart des cas vous pourrez juste envoyer l'objet récupéré de la base de données **directement au client**
 
 Avec **FastAPI** vous aurez toutes les fonctionnalités de **Pydantic**  (comme FastAPI est basé sur Pydantic pour toutes les manipulations de données):
 
@@ -194,7 +194,7 @@ Avec **FastAPI** vous aurez toutes les fonctionnalités de **Pydantic**  (comme
 * Valide les **structures complexes**:
     * Utilise les modèles hiérarchique de Pydantic, le `typage` Python pour les `Lists`, `Dict`, etc.
     * Et les validateurs permettent aux schémas de données complexes d'être clairement et facilement définis, validés et documentés sous forme d'un schéma JSON.
-    * Vous pouvez avoir des objets **JSON fortements imbriqués** tout en ayant, pour chacun, de la validation et des annotations.
+    * Vous pouvez avoir des objets **JSON fortement imbriqués** tout en ayant, pour chacun, de la validation et des annotations.
 * **Renouvelable**:
     * Pydantic permet de définir de nouveaux types de données ou vous pouvez étendre la validation avec des méthodes sur un modèle décoré avec le<abbr title="en anglais: validator decorator"> décorateur de validation</abbr>
 * 100% de couverture de test.
diff --git a/docs/fr/docs/help-fastapi.md b/docs/fr/docs/help-fastapi.md
index 0995721e1..525c699f5 100644
--- a/docs/fr/docs/help-fastapi.md
+++ b/docs/fr/docs/help-fastapi.md
@@ -36,8 +36,8 @@ Vous pouvez :
 * <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">Me suivre sur **Twitter**</a>.
     * Dites-moi comment vous utilisez FastAPI (j'adore entendre ça).
     * Entendre quand je fais des annonces ou que je lance de nouveaux outils.
-* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Vous connectez à moi sur **Linkedin**</a>.
-    * Etre notifié quand je fais des annonces ou que je lance de nouveaux outils (bien que j'utilise plus souvent Twitte 🤷‍♂).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Vous connectez à moi sur **LinkedIn**</a>.
+    * Etre notifié quand je fais des annonces ou que je lance de nouveaux outils (bien que j'utilise plus souvent Twitter 🤷‍♂).
 * Lire ce que j’écris (ou me suivre) sur <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> ou <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
     * Lire d'autres idées, articles, et sur les outils que j'ai créés.
     * Suivez-moi pour lire quand je publie quelque chose de nouveau.
@@ -84,24 +84,6 @@ Vous pouvez <a href="https://github.com/tiangolo/fastapi" class="external-link"
 * Pour corriger une Issue/Bug existant.
 * Pour ajouter une nouvelle fonctionnalité.
 
-## Rejoindre le chat
-
-<a href="https://gitter.im/tiangolo/fastapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge" target="_blank">
-    <img src="https://badges.gitter.im/tiangolo/fastapi.svg" alt="Rejoindre le chat à https://gitter.im/tiangolo/fastapi">
-</a>
-
-Rejoignez le chat sur Gitter: <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">https://gitter.im/tiangolo/fastapi</a>.
-
-Vous pouvez y avoir des conversations rapides avec d'autres personnes, aider les autres, partager des idées, etc.
-
-Mais gardez à l'esprit que, comme il permet une "conversation plus libre", il est facile de poser des questions trop générales et plus difficiles à répondre, de sorte que vous risquez de ne pas recevoir de réponses.
-
-Dans les Issues de GitHub, le modèle vous guidera pour écrire la bonne question afin que vous puissiez plus facilement obtenir une bonne réponse, ou même résoudre le problème vous-même avant même de le poser. Et dans GitHub, je peux m'assurer que je réponds toujours à tout, même si cela prend du temps. Je ne peux pas faire cela personnellement avec le chat Gitter. 😅
-
-Les conversations dans Gitter ne sont pas non plus aussi facilement consultables que dans GitHub, de sorte que les questions et les réponses peuvent se perdre dans la conversation.
-
-De l'autre côté, il y a plus de 1000 personnes dans le chat, il y a donc de fortes chances que vous y trouviez quelqu'un à qui parler, presque tout le temps. 😄
-
 ## Parrainer l'auteur
 
 Vous pouvez également soutenir financièrement l'auteur (moi) via <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a>.
diff --git a/docs/fr/docs/index.md b/docs/fr/docs/index.md
index 7c7547be1..f732fc74c 100644
--- a/docs/fr/docs/index.md
+++ b/docs/fr/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI est un framework web moderne et rapide (haute performance) pour la création d'API avec Python 3.7+, basé sur les annotations de type standard de Python.
+FastAPI est un framework web moderne et rapide (haute performance) pour la création d'API avec Python 3.8+, basé sur les annotations de type standard de Python.
 
 Les principales fonctionnalités sont :
 
@@ -115,7 +115,7 @@ Si vous souhaitez construire une application <abbr title="Command Line Interface
 
 ## Prérequis
 
-Python 3.7+
+Python 3.8+
 
 FastAPI repose sur les épaules de géants :
 
@@ -331,7 +331,7 @@ Vous faites cela avec les types Python standard modernes.
 
 Vous n'avez pas à apprendre une nouvelle syntaxe, les méthodes ou les classes d'une bibliothèque spécifique, etc.
 
-Juste du **Python 3.7+** standard.
+Juste du **Python 3.8+** standard.
 
 Par exemple, pour un `int`:
 
@@ -424,7 +424,7 @@ Pour un exemple plus complet comprenant plus de fonctionnalités, voir le <a hre
 
 * Déclaration de **paramètres** provenant d'autres endroits différents comme : **<abbr title="en anglais : headers">en-têtes</abbr>.**, **cookies**, **champs de formulaire** et **fichiers**.
 * L'utilisation de **contraintes de validation** comme `maximum_length` ou `regex`.
-* Un **<abbr title="aussi connu sous le nom de composants, ressources, fournisseurs, services, injectables">systéme d'injection de dépendance </abbr>** très puissant et facile à utiliser .
+* Un **<abbr title="aussi connu sous le nom de composants, ressources, fournisseurs, services, injectables">système d'injection de dépendance </abbr>** très puissant et facile à utiliser .
 * Sécurité et authentification, y compris la prise en charge de **OAuth2** avec les **<abbr title="en anglais : JWT tokens">jetons <abbr title="JSON Web Tokens">JWT</abbr></abbr>** et l'authentification **HTTP Basic**.
 * Des techniques plus avancées (mais tout aussi faciles) pour déclarer les **modèles <abbr title="JavaScript Object Notation">JSON</abbr> profondément imbriqués** (grâce à Pydantic).
 * Intégration de **GraphQL** avec <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> et d'autres bibliothèques.
@@ -450,7 +450,7 @@ Utilisées par Pydantic:
 Utilisées par Starlette :
 
 * <a href="https://requests.readthedocs.io" target="_blank"><code>requests</code></a> - Obligatoire si vous souhaitez utiliser `TestClient`.
-* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Obligatoire si vous souhaitez utiliser la configuration de template par defaut.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Obligatoire si vous souhaitez utiliser la configuration de template par défaut.
 * <a href="https://andrew-d.github.io/python-multipart/" target="_blank"><code>python-multipart</code></a> - Obligatoire si vous souhaitez supporter le <abbr title="convertit la chaine de caractère d'une requête HTTP en donnée Python">"décodage"</abbr> de formulaire avec `request.form()`.
 * <a href="https://pythonhosted.org/itsdangerous/" target="_blank"><code>itsdangerous</code></a> - Obligatoire pour la prise en charge de `SessionMiddleware`.
 * <a href="https://pyyaml.org/wiki/PyYAMLDocumentation" target="_blank"><code>pyyaml</code></a> - Obligatoire pour le support `SchemaGenerator` de Starlette (vous n'en avez probablement pas besoin avec FastAPI).
diff --git a/docs/fr/docs/python-types.md b/docs/fr/docs/python-types.md
index 4008ed96f..f49fbafd3 100644
--- a/docs/fr/docs/python-types.md
+++ b/docs/fr/docs/python-types.md
@@ -119,7 +119,7 @@ Comme l'éditeur connaît le type des variables, vous n'avez pas seulement l'aut
 
 <img src="/img/python-types/image04.png">
 
-Maintenant que vous avez connaissance du problème, convertissez `age` en <abbr title="string">chaine de caractères</abbr> grâce à `str(age)` :
+Maintenant que vous avez connaissance du problème, convertissez `age` en <abbr title="string">chaîne de caractères</abbr> grâce à `str(age)` :
 
 ```Python hl_lines="2"
 {!../../../docs_src/python_types/tutorial004.py!}
diff --git a/docs/fr/docs/tutorial/body.md b/docs/fr/docs/tutorial/body.md
index 1e732d336..89720c973 100644
--- a/docs/fr/docs/tutorial/body.md
+++ b/docs/fr/docs/tutorial/body.md
@@ -98,7 +98,7 @@ Et vous obtenez aussi de la vérification d'erreur pour les opérations incorrec
 
 <img src="/img/tutorial/body/image04.png">
 
-Ce n'est pas un hasard, ce framework entier a été bati avec ce design comme objectif.
+Ce n'est pas un hasard, ce framework entier a été bâti avec ce design comme objectif.
 
 Et cela a été rigoureusement testé durant la phase de design, avant toute implémentation, pour s'assurer que cela fonctionnerait avec tous les éditeurs.
 
diff --git a/docs/fr/docs/tutorial/first-steps.md b/docs/fr/docs/tutorial/first-steps.md
index 224c340c6..e98283f1e 100644
--- a/docs/fr/docs/tutorial/first-steps.md
+++ b/docs/fr/docs/tutorial/first-steps.md
@@ -170,7 +170,7 @@ Si vous créez votre app avec :
 {!../../../docs_src/first_steps/tutorial002.py!}
 ```
 
-Et la mettez dans un fichier `main.py`, alors vous appeleriez `uvicorn` avec :
+Et la mettez dans un fichier `main.py`, alors vous appelleriez `uvicorn` avec :
 
 <div class="termy">
 
diff --git a/docs/fr/docs/tutorial/index.md b/docs/fr/docs/tutorial/index.md
new file mode 100644
index 000000000..4dc202b33
--- /dev/null
+++ b/docs/fr/docs/tutorial/index.md
@@ -0,0 +1,80 @@
+# Tutoriel - Guide utilisateur - Introduction
+
+Ce tutoriel vous montre comment utiliser **FastAPI** avec la plupart de ses fonctionnalités, étape par étape.
+
+Chaque section s'appuie progressivement sur les précédentes, mais elle est structurée de manière à séparer les sujets, afin que vous puissiez aller directement à l'un d'entre eux pour résoudre vos besoins spécifiques en matière d'API.
+
+Il est également conçu pour fonctionner comme une référence future.
+
+Vous pouvez donc revenir et voir exactement ce dont vous avez besoin.
+
+## Exécuter le code
+
+Tous les blocs de code peuvent être copiés et utilisés directement (il s'agit en fait de fichiers Python testés).
+
+Pour exécuter l'un de ces exemples, copiez le code dans un fichier `main.py`, et commencez `uvicorn` avec :
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+Il est **FORTEMENT encouragé** que vous écriviez ou copiez le code, l'éditiez et l'exécutiez localement.
+
+L'utiliser dans votre éditeur est ce qui vous montre vraiment les avantages de FastAPI, en voyant le peu de code que vous avez à écrire, toutes les vérifications de type, l'autocomplétion, etc.
+
+---
+
+## Installer FastAPI
+
+La première étape consiste à installer FastAPI.
+
+Pour le tutoriel, vous voudrez peut-être l'installer avec toutes les dépendances et fonctionnalités optionnelles :
+
+<div class="termy">
+
+```console
+$ pip install fastapi[all]
+
+---> 100%
+```
+
+</div>
+
+... qui comprend également `uvicorn`, que vous pouvez utiliser comme serveur pour exécuter votre code.
+
+!!! note
+    Vous pouvez également l'installer pièce par pièce.
+
+    C'est ce que vous feriez probablement une fois que vous voudrez déployer votre application en production :
+
+    ```
+    pip install fastapi
+    ```
+
+    Installez également `uvicorn` pour qu'il fonctionne comme serveur :
+
+    ```
+    pip install uvicorn
+    ```
+
+    Et la même chose pour chacune des dépendances facultatives que vous voulez utiliser.
+
+## Guide utilisateur avancé
+
+Il existe également un **Guide d'utilisation avancé** que vous pouvez lire plus tard après ce **Tutoriel - Guide d'utilisation**.
+
+Le **Guide d'utilisation avancé**, qui s'appuie sur cette base, utilise les mêmes concepts et vous apprend quelques fonctionnalités supplémentaires.
+
+Mais vous devez d'abord lire le **Tutoriel - Guide d'utilisation** (ce que vous êtes en train de lire en ce moment).
+
+Il est conçu pour que vous puissiez construire une application complète avec seulement le **Tutoriel - Guide d'utilisation**, puis l'étendre de différentes manières, en fonction de vos besoins, en utilisant certaines des idées supplémentaires du **Guide d'utilisation avancé**.
diff --git a/docs/fr/docs/tutorial/query-params-str-validations.md b/docs/fr/docs/tutorial/query-params-str-validations.md
new file mode 100644
index 000000000..f5248fe8b
--- /dev/null
+++ b/docs/fr/docs/tutorial/query-params-str-validations.md
@@ -0,0 +1,305 @@
+# Paramètres de requête et validations de chaînes de caractères
+
+**FastAPI** vous permet de déclarer des informations et des validateurs additionnels pour vos paramètres de requêtes.
+
+Commençons avec cette application pour exemple :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial001.py!}
+```
+
+Le paramètre de requête `q` a pour type `Union[str, None]` (ou `str | None` en Python 3.10), signifiant qu'il est de type `str` mais pourrait aussi être égal à `None`, et bien sûr, la valeur par défaut est `None`, donc **FastAPI** saura qu'il n'est pas requis.
+
+!!! note
+    **FastAPI** saura que la valeur de `q` n'est pas requise grâce à la valeur par défaut `= None`.
+
+    Le `Union` dans `Union[str, None]` permettra à votre éditeur de vous offrir un meilleur support et de détecter les erreurs.
+
+## Validation additionnelle
+
+Nous allons imposer que bien que `q` soit un paramètre optionnel, dès qu'il est fourni, **sa longueur n'excède pas 50 caractères**.
+
+## Importer `Query`
+
+Pour cela, importez d'abord `Query` depuis `fastapi` :
+
+```Python hl_lines="3"
+{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+```
+
+## Utiliser `Query` comme valeur par défaut
+
+Construisez ensuite la valeur par défaut de votre paramètre avec `Query`, en choisissant 50 comme `max_length` :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+```
+
+Comme nous devons remplacer la valeur par défaut `None` dans la fonction par `Query()`, nous pouvons maintenant définir la valeur par défaut avec le paramètre `Query(default=None)`, il sert le même objectif qui est de définir cette valeur par défaut.
+
+Donc :
+
+```Python
+q: Union[str, None] = Query(default=None)
+```
+
+... rend le paramètre optionnel, et est donc équivalent à :
+
+```Python
+q: Union[str, None] = None
+```
+
+Mais déclare explicitement `q` comme étant un paramètre de requête.
+
+!!! info
+    Gardez à l'esprit que la partie la plus importante pour rendre un paramètre optionnel est :
+
+    ```Python
+    = None
+    ```
+
+    ou :
+
+    ```Python
+    = Query(None)
+    ```
+
+    et utilisera ce `None` pour détecter que ce paramètre de requête **n'est pas requis**.
+
+    Le `Union[str, None]` est uniquement là pour permettre à votre éditeur un meilleur support.
+
+Ensuite, nous pouvons passer d'autres paramètres à `Query`. Dans cet exemple, le paramètre `max_length` qui s'applique aux chaînes de caractères :
+
+```Python
+q: Union[str, None] = Query(default=None, max_length=50)
+```
+
+Cela va valider les données, montrer une erreur claire si ces dernières ne sont pas valides, et documenter le paramètre dans le schéma `OpenAPI` de cette *path operation*.
+
+## Rajouter plus de validation
+
+Vous pouvez aussi rajouter un second paramètre `min_length` :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+```
+
+## Ajouter des validations par expressions régulières
+
+On peut définir une <abbr title="Une expression régulière, regex ou regexp est une suite de caractères qui définit un pattern de correspondance pour les chaînes de caractères.">expression régulière</abbr> à laquelle le paramètre doit correspondre :
+
+```Python hl_lines="10"
+{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+```
+
+Cette expression régulière vérifie que la valeur passée comme paramètre :
+
+* `^` : commence avec les caractères qui suivent, avec aucun caractère avant ceux-là.
+* `fixedquery` : a pour valeur exacte `fixedquery`.
+* `$` : se termine directement ensuite, n'a pas d'autres caractères après `fixedquery`.
+
+Si vous vous sentez perdu avec le concept d'**expression régulière**, pas d'inquiétudes. Il s'agit d'une notion difficile pour beaucoup, et l'on peut déjà réussir à faire beaucoup sans jamais avoir à les manipuler.
+
+Mais si vous décidez d'apprendre à les utiliser, sachez qu'ensuite vous pouvez les utiliser directement dans **FastAPI**.
+
+## Valeurs par défaut
+
+De la même façon que vous pouvez passer `None` comme premier argument pour l'utiliser comme valeur par défaut, vous pouvez passer d'autres valeurs.
+
+Disons que vous déclarez le paramètre `q` comme ayant une longueur minimale de `3`, et une valeur par défaut étant `"fixedquery"` :
+
+```Python hl_lines="7"
+{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+```
+
+!!! note "Rappel"
+    Avoir une valeur par défaut rend le paramètre optionnel.
+
+## Rendre ce paramètre requis
+
+Quand on ne déclare ni validation, ni métadonnée, on peut rendre le paramètre `q` requis en ne lui déclarant juste aucune valeur par défaut :
+
+```Python
+q: str
+```
+
+à la place de :
+
+```Python
+q: Union[str, None] = None
+```
+
+Mais maintenant, on déclare `q` avec `Query`, comme ceci :
+
+```Python
+q: Union[str, None] = Query(default=None, min_length=3)
+```
+
+Donc pour déclarer une valeur comme requise tout en utilisant `Query`, il faut utiliser `...` comme premier argument :
+
+```Python hl_lines="7"
+{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+```
+
+!!! info
+    Si vous n'avez jamais vu ce `...` auparavant : c'est une des constantes natives de Python <a href="https://docs.python.org/fr/3/library/constants.html#Ellipsis" class="external-link" target="_blank">appelée "Ellipsis"</a>.
+
+Cela indiquera à **FastAPI** que la présence de ce paramètre est obligatoire.
+
+## Liste de paramètres / valeurs multiples via Query
+
+Quand on définit un paramètre de requête explicitement avec `Query` on peut aussi déclarer qu'il reçoit une liste de valeur, ou des "valeurs multiples".
+
+Par exemple, pour déclarer un paramètre de requête `q` qui peut apparaître plusieurs fois dans une URL, on écrit :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+```
+
+Ce qui fait qu'avec une URL comme :
+
+```
+http://localhost:8000/items/?q=foo&q=bar
+```
+
+vous recevriez les valeurs des multiples paramètres de requête `q` (`foo` et `bar`) dans une `list` Python au sein de votre fonction de **path operation**, dans le paramètre de fonction `q`.
+
+Donc la réponse de cette URL serait :
+
+```JSON
+{
+  "q": [
+    "foo",
+    "bar"
+  ]
+}
+```
+
+!!! tip "Astuce"
+    Pour déclarer un paramètre de requête de type `list`, comme dans l'exemple ci-dessus, il faut explicitement utiliser `Query`, sinon cela sera interprété comme faisant partie du corps de la requête.
+
+La documentation sera donc mise à jour automatiquement pour autoriser plusieurs valeurs :
+
+<img src="/img/tutorial/query-params-str-validations/image02.png">
+
+### Combiner liste de paramètres et valeurs par défaut
+
+Et l'on peut aussi définir une liste de valeurs par défaut si aucune n'est fournie :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+```
+
+Si vous allez à :
+
+```
+http://localhost:8000/items/
+```
+
+la valeur par défaut de `q` sera : `["foo", "bar"]`
+
+et la réponse sera :
+
+```JSON
+{
+  "q": [
+    "foo",
+    "bar"
+  ]
+}
+```
+
+#### Utiliser `list`
+
+Il est aussi possible d'utiliser directement `list` plutôt que `List[str]` :
+
+```Python hl_lines="7"
+{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+```
+
+!!! note
+    Dans ce cas-là, **FastAPI** ne vérifiera pas le contenu de la liste.
+
+    Par exemple, `List[int]` vérifiera (et documentera) que la liste est bien entièrement composée d'entiers. Alors qu'un simple `list` ne ferait pas cette vérification.
+
+## Déclarer des métadonnées supplémentaires
+
+On peut aussi ajouter plus d'informations sur le paramètre.
+
+Ces informations seront incluses dans le schéma `OpenAPI` généré et utilisées par la documentation interactive ou les outils externes utilisés.
+
+!!! note
+    Gardez en tête que les outils externes utilisés ne supportent pas forcément tous parfaitement OpenAPI.
+
+    Il se peut donc que certains d'entre eux n'utilisent pas toutes les métadonnées que vous avez déclarées pour le moment, bien que dans la plupart des cas, les fonctionnalités manquantes ont prévu d'être implémentées.
+
+Vous pouvez ajouter un `title` :
+
+```Python hl_lines="10"
+{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+```
+
+Et une `description` :
+
+```Python hl_lines="13"
+{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+```
+
+## Alias de paramètres
+
+Imaginez que vous vouliez que votre paramètre se nomme `item-query`.
+
+Comme dans la requête :
+
+```
+http://127.0.0.1:8000/items/?item-query=foobaritems
+```
+
+Mais `item-query` n'est pas un nom de variable valide en Python.
+
+Le nom le plus proche serait `item_query`.
+
+Mais vous avez vraiment envie que ce soit exactement `item-query`...
+
+Pour cela vous pouvez déclarer un `alias`, et cet alias est ce qui sera utilisé pour trouver la valeur du paramètre :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+```
+
+## Déprécier des paramètres
+
+Disons que vous ne vouliez plus utiliser ce paramètre désormais.
+
+Il faut qu'il continue à exister pendant un certain temps car vos clients l'utilisent, mais vous voulez que la documentation mentionne clairement que ce paramètre est <abbr title="obsolète, recommandé de ne pas l'utiliser">déprécié</abbr>.
+
+On utilise alors l'argument `deprecated=True` de `Query` :
+
+```Python hl_lines="18"
+{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+```
+
+La documentation le présentera comme il suit :
+
+<img src="/img/tutorial/query-params-str-validations/image01.png">
+
+## Pour résumer
+
+Il est possible d'ajouter des validateurs et métadonnées pour vos paramètres.
+
+Validateurs et métadonnées génériques:
+
+* `alias`
+* `title`
+* `description`
+* `deprecated`
+
+Validateurs spécifiques aux chaînes de caractères :
+
+* `min_length`
+* `max_length`
+* `regex`
+
+Parmi ces exemples, vous avez pu voir comment déclarer des validateurs pour les chaînes de caractères.
+
+Dans les prochains chapitres, vous verrez comment déclarer des validateurs pour d'autres types, comme les nombres.
diff --git a/docs/fr/docs/tutorial/query-params.md b/docs/fr/docs/tutorial/query-params.md
index 7bf3b9e79..962135f63 100644
--- a/docs/fr/docs/tutorial/query-params.md
+++ b/docs/fr/docs/tutorial/query-params.md
@@ -75,7 +75,7 @@ Ici, le paramètre `q` sera optionnel, et aura `None` comme valeur par défaut.
 !!! note
     **FastAPI** saura que `q` est optionnel grâce au `=None`.
 
-    Le `Optional` dans `Optional[str]` n'est pas utilisé par **FastAPI** (**FastAPI** n'en utilisera que la partie `str`), mais il servira tout de même à votre editeur de texte pour détecter des erreurs dans votre code.
+    Le `Optional` dans `Optional[str]` n'est pas utilisé par **FastAPI** (**FastAPI** n'en utilisera que la partie `str`), mais il servira tout de même à votre éditeur de texte pour détecter des erreurs dans votre code.
 
 
 ## Conversion des types des paramètres de requête
diff --git a/docs/ja/docs/deployment/concepts.md b/docs/ja/docs/deployment/concepts.md
new file mode 100644
index 000000000..38cbca219
--- /dev/null
+++ b/docs/ja/docs/deployment/concepts.md
@@ -0,0 +1,323 @@
+# デプロイメントのコンセプト
+
+**FastAPI**を用いたアプリケーションをデプロイするとき、もしくはどのようなタイプのWeb APIであっても、おそらく気になるコンセプトがいくつかあります。
+
+それらを活用することでアプリケーションを**デプロイするための最適な方法**を見つけることができます。
+
+重要なコンセプトのいくつかを紹介します:
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* レプリケーション（実行中のプロセス数）
+* メモリー
+* 開始前の事前のステップ
+
+これらが**デプロイメント**にどのような影響を与えるかを見ていきましょう。
+
+最終的な目的は、**安全な方法で**APIクライアントに**サービスを提供**し、**中断を回避**するだけでなく、**計算リソース**（例えばリモートサーバー/仮想マシン）を可能な限り効率的に使用することです。🚀
+
+この章では前述した**コンセプト**についてそれぞれ説明します。
+
+この説明を通して、普段とは非常に異なる環境や存在しないであろう**将来の**環境に対し、デプロイの方法を決める上で必要な**直感**を与えてくれることを願っています。
+
+これらのコンセプトを意識することにより、**あなた自身のAPI**をデプロイするための最適な方法を**評価**し、**設計**することができるようになるでしょう。
+
+次の章では、FastAPIアプリケーションをデプロイするための**具体的なレシピ**を紹介します。
+
+しかし、今はこれらの重要な**コンセプトに基づくアイデア**を確認しましょう。これらのコンセプトは、他のどのタイプのWeb APIにも当てはまります。💡
+
+## セキュリティ - HTTPS
+
+<!-- NOTE: https.md written in Japanese does not exist, so it redirects to English one  -->
+[前チャプターのHTTPSについて](./https.md){.internal-link target=_blank}では、HTTPSがどのようにAPIを暗号化するのかについて学びました。
+
+通常、アプリケーションサーバにとって**外部の**コンポーネントである**TLS Termination Proxy**によって提供されることが一般的です。このプロキシは通信の暗号化を担当します。
+
+さらにセキュアな通信において、HTTPS証明書の定期的な更新を行いますが、これはTLS Termination Proxyと同じコンポーネントが担当することもあれば、別のコンポーネントが担当することもあります。
+
+### HTTPS 用ツールの例
+TLS Termination Proxyとして使用できるツールには以下のようなものがあります：
+
+* Traefik
+    * 証明書の更新を自動的に処理 ✨
+* Caddy
+    * 証明書の更新を自動的に処理 ✨
+* Nginx
+    * 証明書更新のためにCertbotのような外部コンポーネントを使用
+* HAProxy
+    * 証明書更新のためにCertbotのような外部コンポーネントを使用
+* Nginx のような Ingress Controller を持つ Kubernetes
+    * 証明書の更新に cert-manager のような外部コンポーネントを使用
+* クラウド・プロバイダーがサービスの一部として内部的に処理（下記を参照👇）
+
+もう1つの選択肢は、HTTPSのセットアップを含んだより多くの作業を行う**クラウド・サービス**を利用することです。 このサービスには制限があったり、料金が高くなったりする可能性があります。しかしその場合、TLS Termination Proxyを自分でセットアップする必要はないです。
+
+次の章で具体例をいくつか紹介します。
+
+---
+
+次に考慮すべきコンセプトは、実際のAPIを実行するプログラム（例：Uvicorn）に関連するものすべてです。
+
+## プログラム と プロセス
+
+私たちは「**プロセス**」という言葉についてたくさん話すので、その意味や「**プログラム**」という言葉との違いを明確にしておくと便利です。
+
+### プログラムとは何か
+
+**プログラム**という言葉は、一般的にいろいろなものを表現するのに使われます：
+
+* プログラマが書く**コード**、**Pythonファイル**
+* OSによって実行することができるファイル（例: `python`, `python.exe` or `uvicorn`）
+* OS上で**実行**している間、CPUを使用し、メモリ上に何かを保存する特定のプログラム（**プロセス**とも呼ばれる）
+
+### プロセスとは何か
+
+**プロセス**という言葉は通常、より具体的な意味で使われ、OSで実行されているものだけを指します（先ほどの最後の説明のように）：
+
+* OS上で**実行**している特定のプログラム
+    * これはファイルやコードを指すのではなく、OSによって**実行**され、管理されているものを指します。
+* どんなプログラムやコードも、それが**実行されているときにだけ機能**します。つまり、**プロセスとして実行されているときだけ**です。
+* プロセスは、ユーザーにあるいはOSによって、 **終了**（あるいは "kill"）させることができます。その時点で、プロセスは実行/実行されることを停止し、それ以降は**何もできなくなります**。
+* コンピュータで実行されている各アプリケーションは、実行中のプログラムや各ウィンドウなど、その背後にいくつかのプロセスを持っています。そして通常、コンピュータが起動している間、**多くのプロセスが**同時に実行されています。
+* **同じプログラム**の**複数のプロセス**が同時に実行されていることがあります。
+
+OSの「タスク・マネージャー」や「システム・モニター」（または同様のツール）を確認すれば、これらのプロセスの多くが実行されているの見ることができるでしょう。
+
+例えば、同じブラウザプログラム（Firefox、Chrome、Edgeなど）を実行しているプロセスが複数あることがわかります。通常、1つのタブにつき1つのプロセスが実行され、さらに他のプロセスも実行されます。
+
+<img class="shadow" src="/img/deployment/concepts/image01.png">
+
+---
+
+さて、**プロセス**と**プログラム**という用語の違いを確認したところで、デプロイメントについて話を続けます。
+
+## 起動時の実行
+
+ほとんどの場合、Web APIを作成するときは、クライアントがいつでもアクセスできるように、**常に**中断されることなく**実行される**ことを望みます。もちろん、特定の状況でのみ実行させたい特別な理由がある場合は別ですが、その時間のほとんどは、常に実行され、**利用可能**であることを望みます。
+
+### リモートサーバー上での実行
+
+リモートサーバー（クラウドサーバー、仮想マシンなど）をセットアップするときにできる最も簡単なことは、ローカルで開発するときと同じように、Uvicorn（または同様のもの）を手動で実行することです。 この方法は**開発中**には役に立つと思われます。
+
+しかし、サーバーへの接続が切れた場合、**実行中のプロセス**はおそらくダウンしてしまうでしょう。
+
+そしてサーバーが再起動された場合（アップデートやクラウドプロバイダーからのマイグレーションの後など）、おそらくあなたはそれに**気づかないでしょう**。そのため、プロセスを手動で再起動しなければならないことすら気づかないでしょう。つまり、APIはダウンしたままなのです。😱
+
+### 起動時に自動的に実行
+
+一般的に、サーバープログラム（Uvicornなど）はサーバー起動時に自動的に開始され、**人の介入**を必要とせずに、APIと一緒にプロセスが常に実行されるようにしたいと思われます（UvicornがFastAPIアプリを実行するなど）。
+
+### 別のプログラムの用意
+
+これを実現するために、通常は**別のプログラム**を用意し、起動時にアプリケーションが実行されるようにします。そして多くの場合、他のコンポーネントやアプリケーション、例えばデータベースも実行されるようにします。
+
+### 起動時に実行するツールの例
+
+実行するツールの例をいくつか挙げます:
+
+* Docker
+* Kubernetes
+* Docker Compose
+* Swarm モードによる Docker
+* Systemd
+* Supervisor
+* クラウドプロバイダーがサービスの一部として内部的に処理
+* そのほか...
+
+次の章で、より具体的な例を挙げていきます。
+
+## 再起動
+
+起動時にアプリケーションが実行されることを確認するのと同様に、失敗後にアプリケーションが**再起動**されることも確認したいと思われます。
+
+### 我々は間違いを犯す
+
+私たち人間は常に**間違い**を犯します。ソフトウェアには、ほとんど常に**バグ**があらゆる箇所に隠されています。🐛
+
+### 小さなエラーは自動的に処理される
+
+FastAPIでWeb APIを構築する際に、コードにエラーがある場合、FastAPIは通常、エラーを引き起こした単一のリクエストにエラーを含めます。🛡
+
+クライアントはそのリクエストに対して**500 Internal Server Error**を受け取りますが、アプリケーションは完全にクラッシュするのではなく、次のリクエストのために動作を続けます。
+
+### 重大なエラー - クラッシュ
+
+しかしながら、**アプリケーション全体をクラッシュさせるようなコードを書いて**UvicornとPythonをクラッシュさせるようなケースもあるかもしれません。💥
+
+それでも、ある箇所でエラーが発生したからといって、アプリケーションを停止させたままにしたくないでしょう。 少なくとも壊れていない*パスオペレーション*については、**実行し続けたい**はずです。
+
+### クラッシュ後の再起動
+
+しかし、実行中の**プロセス**をクラッシュさせるような本当にひどいエラーの場合、少なくとも2〜3回ほどプロセスを**再起動**させる外部コンポーネントが必要でしょう。
+
+!!! tip
+    ...とはいえ、アプリケーション全体が**すぐにクラッシュする**のであれば、いつまでも再起動し続けるのは意味がないでしょう。しかし、その場合はおそらく開発中か少なくともデプロイ直後に気づくと思われます。
+
+    そこで、**将来**クラッシュする可能性があり、それでも再スタートさせることに意味があるような、主なケースに焦点を当ててみます。
+
+あなたはおそらく**外部コンポーネント**がアプリケーションの再起動を担当することを望むと考えます。 なぜなら、その時点でUvicornとPythonを使った同じアプリケーションはすでにクラッシュしており、同じアプリケーションの同じコードに対して何もできないためです。
+
+### 自動的に再起動するツールの例
+
+ほとんどの場合、前述した**起動時にプログラムを実行する**ために使用されるツールは、自動で**再起動**することにも利用されます。
+
+例えば、次のようなものがあります：
+
+* Docker
+* Kubernetes
+* Docker Compose
+* Swarm モードによる Docker
+* Systemd
+* Supervisor
+* クラウドプロバイダーがサービスの一部として内部的に処理
+* そのほか...
+
+## レプリケーション - プロセスとメモリー
+
+FastAPI アプリケーションでは、Uvicorn のようなサーバープログラムを使用し、**1つのプロセス**で1度に複数のクライアントに同時に対応できます。
+
+しかし、多くの場合、複数のワーカー・プロセスを同時に実行したいと考えるでしょう。
+
+### 複数のプロセス - Worker
+
+クライアントの数が単一のプロセスで処理できる数を超えており（たとえば仮想マシンがそれほど大きくない場合）、かつサーバーの CPU に**複数のコア**がある場合、同じアプリケーションで同時に**複数のプロセス**を実行させ、すべてのリクエストを分散させることができます。
+
+同じAPIプログラムの**複数のプロセス**を実行する場合、それらは一般的に**Worker／ワーカー**と呼ばれます。
+
+### ワーカー・プロセス と ポート
+<!-- NOTE: https.md written in Japanese does not exist, so it redirects to English one  -->
+
+[HTTPSについて](./https.md){.internal-link target=_blank}のドキュメントで、1つのサーバーで1つのポートとIPアドレスの組み合わせでリッスンできるのは1つのプロセスだけであることを覚えていますでしょうか？
+
+これはいまだに同じです。
+
+そのため、**複数のプロセス**を同時に持つには**ポートでリッスンしている単一のプロセス**が必要であり、それが何らかの方法で各ワーカー・プロセスに通信を送信することが求められます。
+
+### プロセスあたりのメモリー
+
+さて、プログラムがメモリにロードする際には、例えば機械学習モデルや大きなファイルの内容を変数に入れたりする場合では、**サーバーのメモリ（RAM）**を少し消費します。
+
+そして複数のプロセスは通常、**メモリを共有しません**。これは、実行中の各プロセスがそれぞれ独自の変数やメモリ等を持っていることを意味します。つまり、コード内で大量のメモリを消費している場合、**各プロセス**は同等の量のメモリを消費することになります。
+
+### サーバーメモリー
+
+例えば、あなたのコードが **1GBのサイズの機械学習モデル**をロードする場合、APIで1つのプロセスを実行すると、少なくとも1GBのRAMを消費します。
+
+また、**4つのプロセス**（4つのワーカー）を起動すると、それぞれが1GBのRAMを消費します。つまり、合計でAPIは**4GBのRAM**を消費することになります。
+
+リモートサーバーや仮想マシンのRAMが3GBしかない場合、4GB以上のRAMをロードしようとすると問題が発生します。🚨
+
+### 複数プロセス - 例
+
+この例では、2つの**ワーカー・プロセス**を起動し制御する**マネージャー・ プロセス**があります。
+
+このマネージャー・ プロセスは、おそらくIPの**ポート**でリッスンしているものです。そして、すべての通信をワーカー・プロセスに転送します。
+
+これらのワーカー・プロセスは、アプリケーションを実行するものであり、**リクエスト**を受けて**レスポンス**を返すための主要な計算を行い、あなたが変数に入れたものは何でもRAMにロードします。
+
+<img src="/img/deployment/concepts/process-ram.svg">
+
+そしてもちろん、同じマシンでは、あなたのアプリケーションとは別に、**他のプロセス**も実行されているでしょう。
+
+興味深いことに、各プロセスが使用する**CPU**の割合は時間とともに大きく**変動**する可能性がありますが、**メモリ（RAM）**は通常、多かれ少なかれ**安定**します。
+
+毎回同程度の計算を行うAPIがあり、多くのクライアントがいるのであれば、**CPU使用率**もおそらく**安定**するでしょう（常に急激に上下するのではなく）。
+
+### レプリケーション・ツールと戦略の例
+
+これを実現するにはいくつかのアプローチがありますが、具体的な戦略については次の章(Dockerやコンテナの章など)で詳しく説明します。
+
+考慮すべき主な制約は、**パブリックIP**の**ポート**を処理する**単一の**コンポーネントが存在しなければならないということです。
+
+そして、レプリケートされた**プロセス/ワーカー**に通信を**送信**する方法を持つ必要があります。
+
+考えられる組み合わせと戦略をいくつか紹介します：
+
+* **Gunicorn**が**Uvicornワーカー**を管理
+    * Gunicornは**IP**と**ポート**をリッスンする**プロセスマネージャ**で、レプリケーションは**複数のUvicornワーカー・プロセス**を持つことによって行われる。
+* **Uvicorn**が**Uvicornワーカー**を管理
+    * 1つのUvicornの**プロセスマネージャー**が**IP**と**ポート**をリッスンし、**複数のUvicornワーカー・プロセス**を起動する。
+* **Kubernetes**やその他の分散**コンテナ・システム**
+    * **Kubernetes**レイヤーの何かが**IP**と**ポート**をリッスンする。レプリケーションは、**複数のコンテナ**にそれぞれ**1つのUvicornプロセス**を実行させることで行われる。
+* **クラウド・サービス**によるレプリケーション
+    * クラウド・サービスはおそらく**あなたのためにレプリケーションを処理**します。**実行するプロセス**や使用する**コンテナイメージ**を定義できるかもしれませんが、いずれにせよ、それはおそらく**単一のUvicornプロセス**であり、クラウドサービスはそのレプリケーションを担当するでしょう。
+
+!!! tip
+    これらの**コンテナ**やDockerそしてKubernetesに関する項目が、まだあまり意味をなしていなくても心配しないでください。
+    <!-- NOTE: the current version of docker.md is outdated compared to English one. -->
+
+    コンテナ・イメージ、Docker、Kubernetesなどについては、次の章で詳しく説明します: [コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}.
+
+## 開始前の事前のステップ
+
+アプリケーションを**開始する前**に、いくつかのステップを実行したい場合が多くあります。
+
+例えば、**データベース・マイグレーション** を実行したいかもしれません。
+
+しかしほとんどの場合、これらの手順を**1度**に実行したいと考えるでしょう。
+
+そのため、アプリケーションを開始する前の**事前のステップ**を実行する**単一のプロセス**を用意したいと思われます。
+
+そして、それらの事前のステップを実行しているのが単一のプロセスであることを確認する必要があります。このことはその後アプリケーション自体のために**複数のプロセス**（複数のワーカー）を起動した場合も同様です。
+
+これらのステップが**複数のプロセス**によって実行された場合、**並列**に実行されることによって作業が**重複**することになります。そして、もしそのステップがデータベースのマイグレーションのような繊細なものであった場合、互いに競合を引き起こす可能性があります。
+
+もちろん、事前のステップを何度も実行しても問題がない場合もあり、その際は対処がかなり楽になります。
+
+!!! tip
+    また、セットアップによっては、アプリケーションを開始する前の**事前のステップ**が必要ない場合もあることを覚えておいてください。
+
+    その場合は、このようなことを心配する必要はないです。🤷
+
+### 事前ステップの戦略例
+
+これは**システムを**デプロイする方法に**大きく依存**するだろうし、おそらくプログラムの起動方法や再起動の処理などにも関係してくるでしょう。
+
+考えられるアイデアをいくつか挙げてみます：
+
+* アプリコンテナの前に実行されるKubernetesのInitコンテナ
+* 事前のステップを実行し、アプリケーションを起動するbashスクリプト
+    * 利用するbashスクリプトを起動／再起動したり、エラーを検出したりする方法は以前として必要になるでしょう。
+
+!!! tip
+   <!-- NOTE: the current version of docker.md is outdated compared to English one. -->
+   コンテナを使った具体的な例については、次の章で紹介します: [コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}.
+
+## リソースの利用
+
+あなたのサーバーは**リソース**であり、プログラムを実行しCPUの計算時間や利用可能なRAMメモリを消費または**利用**することができます。
+
+システムリソースをどれくらい消費／利用したいですか？ 「少ない方が良い」と考えるのは簡単かもしれないですが、実際には、**クラッシュせずに可能な限り**最大限に活用したいでしょう。
+
+3台のサーバーにお金を払っているにも関わらず、そのRAMとCPUを少ししか使っていないとしたら、おそらく**お金を無駄にしている** 💸、おそらく**サーバーの電力を無駄にしている** 🌎ことになるでしょう。
+
+その場合は、サーバーを2台だけにして、そのリソース（CPU、メモリ、ディスク、ネットワーク帯域幅など）をより高い割合で使用する方がよいでしょう。
+
+一方、2台のサーバーがあり、そのCPUとRAMの**100%を使用している**場合、ある時点で1つのプロセスがより多くのメモリを要求し、サーバーはディスクを「メモリ」として使用しないといけません。（何千倍も遅くなる可能性があります。）
+もしくは**クラッシュ**することもあれば、あるいはあるプロセスが何らかの計算をする必要があり、そしてCPUが再び空くまで待たなければならないかもしれません。
+
+この場合、**1つ余分なサーバー**を用意し、その上でいくつかのプロセスを実行し、すべてのサーバーが**十分なRAMとCPU時間を持つようにする**のがよいでしょう。
+
+また、何らかの理由でAPIの利用が急増する可能性もあります。もしかしたらそれが流行ったのかもしれないし、他のサービスやボットが使い始めたのかもしれないです。そのような場合に備えて、余分なリソースを用意しておくと安心でしょう。
+
+例えば、リソース使用率の**50%から90%の範囲**で**任意の数字**をターゲットとすることができます。
+
+重要なのは、デプロイメントを微調整するためにターゲットを設定し測定することが、おそらく使用したい主要な要素であることです。
+
+`htop`のような単純なツールを使って、サーバーで使用されているCPUやRAM、あるいは各プロセスで使用されている量を見ることができます。あるいは、より複雑な監視ツールを使って、サーバに分散して使用することもできます。
+
+## まとめ
+
+アプリケーションのデプロイ方法を決定する際に、考慮すべきであろう主要なコンセプトのいくつかを紹介していきました：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* レプリケーション（実行中のプロセス数）
+* メモリー
+* 開始前の事前ステップ
+
+これらの考え方とその適用方法を理解することで、デプロイメントを設定したり調整したりする際に必要な直感的な判断ができるようになるはずです。🤓
+
+次のセクションでは、あなたが取り得る戦略について、より具体的な例を挙げます。🚀
diff --git a/docs/ja/docs/deployment/deta.md b/docs/ja/docs/deployment/deta.md
deleted file mode 100644
index 723f169a0..000000000
--- a/docs/ja/docs/deployment/deta.md
+++ /dev/null
@@ -1,240 +0,0 @@
-# Deta にデプロイ
-
-このセクションでは、**FastAPI** アプリケーションを <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> の無料プランを利用して、簡単にデプロイする方法を学習します。🎁
-
-所要時間は約**10分**です。
-
-!!! info "備考"
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> は **FastAPI** のスポンサーです。🎉
-
-## ベーシックな **FastAPI** アプリ
-
-* アプリのためのディレクトリ (例えば `./fastapideta/`) を作成し、その中に入ってください。
-
-### FastAPI のコード
-
-* 以下の `main.py` ファイルを作成してください:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Requirements
-
-では、同じディレクトリに以下の `requirements.txt` ファイルを作成してください:
-
-```text
-fastapi
-```
-
-!!! tip "豆知識"
-    アプリのローカルテストのために Uvicorn をインストールしたくなるかもしれませんが、Deta へのデプロイには不要です。
-
-### ディレクトリ構造
-
-以下の2つのファイルと1つの `./fastapideta/` ディレクトリがあるはずです:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Detaの無料アカウントの作成
-
-それでは、<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Detaの無料アカウント</a>を作成しましょう。必要なものはメールアドレスとパスワードだけです。
-
-クレジットカードさえ必要ありません。
-
-## CLIのインストール
-
-アカウントを取得したら、Deta <abbr title="Command Line Interface application">CLI</abbr> をインストールしてください:
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-インストールしたら、インストールした CLI を有効にするために新たなターミナルを開いてください。
-
-新たなターミナル上で、正しくインストールされたか確認します:
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip "豆知識"
-    CLI のインストールに問題が発生した場合は、<a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">Deta 公式ドキュメント</a>を参照してください。
-
-## CLIでログイン
-
-CLI から Deta にログインしてみましょう:
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-自動的にウェブブラウザが開いて、認証処理が行われます。
-
-## Deta でデプロイ
-
-次に、アプリケーションを Deta CLIでデプロイしましょう:
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-次のようなJSONメッセージが表示されます:
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip "豆知識"
-    あなたのデプロイでは異なる `"endpoint"` URLが表示されるでしょう。
-
-## 確認
-
-それでは、`endpoint` URLをブラウザで開いてみましょう。上記の例では `https://qltnci.deta.dev` ですが、あなたのURLは異なるはずです。
-
-FastAPIアプリから返ってきたJSONレスポンスが表示されます:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-そして `/docs` へ移動してください。上記の例では、`https://qltnci.deta.dev/docs` です。
-
-次のようなドキュメントが表示されます:
-
-<img src="/img/deployment/deta/image01.png">
-
-## パブリックアクセスの有効化
-
-デフォルトでは、Deta はクッキーを用いてアカウントの認証を行います。
-
-しかし、準備が整えば、以下の様に公開できます:
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-ここで、URLを共有するとAPIにアクセスできるようになります。🚀
-
-## HTTPS
-
-おめでとうございます！あなたの FastAPI アプリが Deta へデプロイされました！🎉 🍰
-
-また、DetaがHTTPSを正しく処理するため、その処理を行う必要がなく、クライアントは暗号化された安全な通信が利用できます。✅ 🔒
-
-## Visor を確認
-
-ドキュメントUI (`https://qltnci.deta.dev/docs` のようなURLにある) は *path operation* `/items/{item_id}` へリクエストを送ることができます。
-
-ID `5` の例を示します。
-
-まず、<a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a> へアクセスします。
-
-左側に各アプリの <abbr title="it comes from Micro(server)">「Micros」</abbr> というセクションが表示されます。
-
-また、「Details」や「Visor」タブが表示されています。「Visor」タブへ移動してください。
-
-そこでアプリに送られた直近のリクエストが調べられます。
-
-また、それらを編集してリプレイできます。
-
-<img src="/img/deployment/deta/image02.png">
-
-## さらに詳しく知る
-
-様々な箇所で永続的にデータを保存したくなるでしょう。そのためには <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a> を使用できます。惜しみない **無料利用枠** もあります。
-
-詳しくは <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">Deta ドキュメント</a>を参照してください。
diff --git a/docs/ja/docs/deployment/docker.md b/docs/ja/docs/deployment/docker.md
index f10312b51..ca9dedc3c 100644
--- a/docs/ja/docs/deployment/docker.md
+++ b/docs/ja/docs/deployment/docker.md
@@ -1,71 +1,157 @@
-# Dockerを使用したデプロイ
+# コンテナ内のFastAPI - Docker
 
-このセクションでは以下の使い方の紹介とガイドへのリンクが確認できます:
+FastAPIアプリケーションをデプロイする場合、一般的なアプローチは**Linuxコンテナ・イメージ**をビルドすることです。
 
-* **5分**程度で、**FastAPI** のアプリケーションを、パフォーマンスを最大限に発揮するDockerイメージ (コンテナ)にする。
-* (オプション) 開発者として必要な範囲でHTTPSを理解する。
-* **20分**程度で、自動的なHTTPS生成とともにDockerのSwarmモード クラスタをセットアップする (月5ドルのシンプルなサーバー上で)。
-* **10分**程度で、DockerのSwarmモード クラスタを使って、HTTPSなどを使用した完全な**FastAPI** アプリケーションの作成とデプロイ。
+基本的には <a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a>を用いて行われます。生成されたコンテナ・イメージは、いくつかの方法のいずれかでデプロイできます。
 
-デプロイのために、<a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a> を利用できます。セキュリティ、再現性、開発のシンプルさなどに利点があります。
+Linuxコンテナの使用には、**セキュリティ**、**反復可能性（レプリカビリティ）**、**シンプリシティ**など、いくつかの利点があります。
 
-Dockerを使う場合、公式のDockerイメージが利用できます:
+!!! tip
+    TODO: なぜか遷移できない
+    お急ぎで、すでにこれらの情報をご存じですか？ [以下の`Dockerfile`の箇所👇](#build-a-docker-image-for-fastapi)へジャンプしてください。
 
-## <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>
-
-このイメージは「自動チューニング」機構を含んでいます。犠牲を払うことなく、ただコードを加えるだけで自動的に高パフォーマンスを実現できます。
-
-ただし、環境変数や設定ファイルを使って全ての設定の変更や更新を行えます。
-
-!!! tip "豆知識"
-    全ての設定とオプションを確認するには、Dockerイメージページを開いて下さい: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
-
-## `Dockerfile` の作成
-
-* プロジェクトディレクトリへ移動。
-* 以下の`Dockerfile` を作成:
+<details>
+<summary>Dockerfile プレビュー 👀</summary>
 
 ```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
+FROM python:3.9
 
-COPY ./app /app
-```
+WORKDIR /code
 
-### より大きなアプリケーション
+COPY ./requirements.txt /code/requirements.txt
 
-[Bigger Applications with Multiple Files](tutorial/bigger-applications.md){.internal-link target=_blank} セクションに倣う場合は、`Dockerfile` は上記の代わりに、以下の様になるかもしれません:
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
 
-```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
-
-COPY ./app /app/app
-```
-
-### Raspberry Piなどのアーキテクチャ
-
-Raspberry Pi (ARMプロセッサ搭載)やそれ以外のアーキテクチャでDockerが作動している場合、(マルチアーキテクチャである) Pythonベースイメージを使って、一から`Dockerfile`を作成し、Uvicornを単体で使用できます。
-
-この場合、`Dockerfile` は以下の様になるかもしれません:
-
-```Dockerfile
-FROM python:3.7
-
-RUN pip install fastapi uvicorn
-
-EXPOSE 80
-
-COPY ./app /app
+COPY ./app /code/app
 
 CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+
+# If running behind a proxy like Nginx or Traefik add --proxy-headers
+# CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80", "--proxy-headers"]
 ```
 
-## **FastAPI** コードの作成
+</details>
 
-* `app` ディレクトリを作成し、移動。
-* 以下の`main.py` ファイルを作成:
+## コンテナとは何か
+
+コンテナ（主にLinuxコンテナ）は、同じシステム内の他のコンテナ（他のアプリケーションやコンポーネント）から隔離された状態を保ちながら、すべての依存関係や必要なファイルを含むアプリケーションをパッケージ化する非常に**軽量**な方法です。
+
+Linuxコンテナは、ホスト（マシン、仮想マシン、クラウドサーバーなど）の同じLinuxカーネルを使用して実行されます。これは、（OS全体をエミュレートする完全な仮想マシンと比べて）非常に軽量であることを意味します。
+
+このように、コンテナは**リソースをほとんど消費しません**が、プロセスを直接実行するのに匹敵する量です（仮想マシンはもっと消費します）。
+
+コンテナはまた、独自の**分離された**実行プロセス（通常は1つのプロセスのみ）や、ファイルシステム、ネットワークを持ちます。 このことはデプロイ、セキュリティ、開発などを簡素化させます。
+
+## コンテナ・イメージとは何か
+
+**コンテナ**は、**コンテナ・イメージ**から実行されます。
+
+コンテナ・イメージは、コンテナ内に存在すべきすべてのファイルや環境変数、そしてデフォルトのコマンド/プログラムを**静的に**バージョン化したものです。 ここでの**静的**とは、コンテナ**イメージ**は実行されておらず、パッケージ化されたファイルとメタデータのみであることを意味します。
+
+保存された静的コンテンツである「**コンテナイメージ**」とは対照的に、「**コンテナ**」は通常、実行中のインスタンス、つまり**実行**されているものを指します。
+
+**コンテナ**が起動され実行されるとき（**コンテナイメージ**から起動されるとき）、ファイルや環境変数などが作成されたり変更されたりする可能性があります。
+
+これらの変更はそのコンテナ内にのみ存在しますが、基盤となるコンテナ・イメージには残りません（ディスクに保存されません）。
+
+コンテナイメージは **プログラム** ファイルやその内容、例えば `python` と `main.py` ファイルに匹敵します。
+
+そして、**コンテナ**自体は（**コンテナイメージ**とは対照的に）イメージをもとにした実際の実行中のインスタンスであり、**プロセス**に匹敵します。
+
+実際、コンテナが実行されているのは、**プロセスが実行されている**ときだけです（通常は単一のプロセスだけです）。 コンテナ内で実行中のプロセスがない場合、コンテナは停止します。
+
+## コンテナ・イメージ
+
+Dockerは、**コンテナ・イメージ**と**コンテナ**を作成・管理するための主要なツールの1つです。
+
+そして、DockerにはDockerイメージ（コンテナ）を共有する<a href="https://hub.docker.com/" class="external-link" target="_blank">Docker Hub</a>というものがあります。
+
+Docker Hubは 多くのツールや環境、データベース、アプリケーションに対応している予め作成された**公式のコンテナ・イメージ**をパブリックに提供しています。
+
+例えば、公式イメージの1つに<a href="https://hub.docker.com/_/python" class="external-link" target="_blank">Python Image</a>があります。
+
+その他にも、データベースなどさまざまなイメージがあります：
+
+* <a href="https://hub.docker.com/_/postgres" class="external-link" target="_blank">PostgreSQL</a>
+* <a href="https://hub.docker.com/_/mysql" class="external-link" target="_blank">MySQL</a>
+* <a href="https://hub.docker.com/_/mongo" class="external-link" target="_blank">MongoDB</a>
+* <a href="https://hub.docker.com/_/redis" class="external-link" target="_blank">Redis</a>, etc.
+
+予め作成されたコンテナ・イメージを使用することで、異なるツールを**組み合わせて**使用することが非常に簡単になります。例えば、新しいデータベースを試す場合に特に便利です。ほとんどの場合、**公式イメージ**を使い、環境変数で設定するだけで良いです。
+
+そうすれば多くの場合、コンテナとDockerについて学び、その知識をさまざまなツールやコンポーネントによって再利用することができます。
+
+つまり、データベース、Pythonアプリケーション、Reactフロントエンド・アプリケーションを備えたウェブ・サーバーなど、さまざまなものを**複数のコンテナ**で実行し、それらを内部ネットワーク経由で接続します。
+
+すべてのコンテナ管理システム（DockerやKubernetesなど）には、こうしたネットワーキング機能が統合されています。
+
+## コンテナとプロセス
+
+通常、**コンテナ・イメージ**はそのメタデータに**コンテナ**の起動時に実行されるデフォルトのプログラムまたはコマンドと、そのプログラムに渡されるパラメータを含みます。コマンドラインでの操作とよく似ています。
+
+**コンテナ**が起動されると、そのコマンド/プログラムが実行されます（ただし、別のコマンド/プログラムをオーバーライドして実行させることもできます）。
+
+コンテナは、**メイン・プロセス**（コマンドまたはプログラム）が実行されている限り実行されます。
+
+コンテナは通常**1つのプロセス**を持ちますが、メイン・プロセスからサブ・プロセスを起動することも可能で、そうすれば同じコンテナ内に**複数のプロセス**を持つことになります。
+
+しかし、**少なくとも1つの実行中のプロセス**がなければ、実行中のコンテナを持つことはできないです。メイン・プロセスが停止すれば、コンテナも停止します。
+
+## Build a Docker Image for FastAPI
+
+ということで、何か作りましょう！🚀
+
+FastAPI用の**Dockerイメージ**を、**公式Python**イメージに基づいて**ゼロから**ビルドする方法をお見せします。
+
+これは**ほとんどの場合**にやりたいことです。例えば：
+
+* **Kubernetes**または同様のツールを使用する場合
+* **Raspberry Pi**で実行する場合
+* コンテナ・イメージを実行してくれるクラウド・サービスなどを利用する場合
+
+### パッケージ要件（package requirements）
+
+アプリケーションの**パッケージ要件**は通常、何らかのファイルに記述されているはずです。
+
+パッケージ要件は主に**インストール**するために使用するツールに依存するでしょう。
+
+最も一般的な方法は、`requirements.txt` ファイルにパッケージ名とそのバージョンを 1 行ずつ書くことです。
+
+もちろん、[FastAPI バージョンについて](./versions.md){.internal-link target=_blank}で読んだのと同じアイデアを使用して、バージョンの範囲を設定します。
+
+例えば、`requirements.txt` は次のようになります：
+
+```
+fastapi>=0.68.0,<0.69.0
+pydantic>=1.8.0,<2.0.0
+uvicorn>=0.15.0,<0.16.0
+```
+
+そして通常、例えば `pip` を使ってこれらのパッケージの依存関係をインストールします：
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+Successfully installed fastapi pydantic uvicorn
+```
+
+</div>
+
+!!! info
+    パッケージの依存関係を定義しインストールするためのフォーマットやツールは他にもあります。
+
+    Poetryを使った例は、後述するセクションでご紹介します。👇
+
+### **FastAPI**コードを作成する
+
+* `app` ディレクトリを作成し、その中に入ります
+* 空のファイル `__init__.py` を作成します
+* `main.py` ファイルを作成します：
 
 ```Python
-from typing import Optional
+from typing import Union
 
 from fastapi import FastAPI
 
@@ -78,23 +164,136 @@ def read_root():
 
 
 @app.get("/items/{item_id}")
-def read_item(item_id: int, q: Optional[str] = None):
+def read_item(item_id: int, q: Union[str, None] = None):
     return {"item_id": item_id, "q": q}
 ```
 
-* ここでは、以下の様なディレクトリ構造になっているはずです:
+### Dockerfile
+
+同じプロジェクト・ディレクトリに`Dockerfile`というファイルを作成します：
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9
+
+# (2)
+WORKDIR /code
+
+# (3)
+COPY ./requirements.txt /code/requirements.txt
+
+# (4)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (5)
+COPY ./app /code/app
+
+# (6)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. 公式のPythonベースイメージから始めます
+
+2. 現在の作業ディレクトリを `/code` に設定します
+
+    ここに `requirements.txt` ファイルと `app` ディレクトリを置きます。
+
+3. 要件が書かれたファイルを `/code` ディレクトリにコピーします
+
+    残りのコードではなく、最初に必要なファイルだけをコピーしてください。
+
+    このファイルは**頻繁には変更されない**ので、Dockerはこのステップではそれを検知し**キャッシュ**を使用し、次のステップでもキャッシュを有効にします。
+
+4. 要件ファイルにあるパッケージの依存関係をインストールします
+    `--no-cache-dir` オプションはダウンロードしたパッケージをローカルに保存しないように `pip` に指示します。これは、同じパッケージをインストールするために `pip` を再度実行する場合にのみ有効ですが、コンテナで作業する場合はそうではないです。
+
+    !!! note
+        `--no-cache-dir`は`pip`に関連しているだけで、Dockerやコンテナとは何の関係もないです。
+
+    `--upgrade` オプションは、パッケージが既にインストールされている場合、`pip` にアップグレードするように指示します。
+
+    何故ならファイルをコピーする前のステップは**Dockerキャッシュ**によって検出される可能性があるためであり、このステップも利用可能な場合は**Dockerキャッシュ**を使用します。
+
+    このステップでキャッシュを使用すると、開発中にイメージを何度もビルドする際に、**毎回**すべての依存関係を**ダウンロードしてインストールする**代わりに多くの**時間**を**節約**できます。
+
+5. ./app` ディレクトリを `/code` ディレクトリの中にコピーする。
+
+    これには**最も頻繁に変更される**すべてのコードが含まれているため、Dockerの**キャッシュ**は**これ以降のステップ**に簡単に使用されることはありません。
+
+    そのため、コンテナイメージのビルド時間を最適化するために、`Dockerfile`の **最後** にこれを置くことが重要です。
+
+6. `uvicorn`サーバーを実行するための**コマンド**を設定します
+
+    `CMD` は文字列のリストを取り、それぞれの文字列はスペースで区切られたコマンドラインに入力するものです。
+
+    このコマンドは **現在の作業ディレクトリ**から実行され、上記の `WORKDIR /code` にて設定した `/code` ディレクトリと同じです。
+
+    そのためプログラムは `/code` で開始しその中にあなたのコードがある `./app` ディレクトリがあるので、**Uvicorn** は `app.main` から `app` を参照し、**インポート** することができます。
+
+!!! tip
+    コード内の"+"の吹き出しをクリックして、各行が何をするのかをレビューしてください。👆
+
+これで、次のようなディレクトリ構造になるはずです：
 
 ```
 .
 ├── app
+│   ├── __init__.py
 │   └── main.py
-└── Dockerfile
+├── Dockerfile
+└── requirements.txt
 ```
 
-## Dockerイメージをビルド
+#### TLS Termination Proxyの裏側
 
-* プロジェクトディレクトリ (`app` ディレクトリを含んだ、`Dockerfile` のある場所) へ移動
-* FastAPIイメージのビルド:
+Nginx や Traefik のような TLS Termination Proxy (ロードバランサ) の後ろでコンテナを動かしている場合は、`--proxy-headers`オプションを追加します。
+
+このオプションは、Uvicornにプロキシ経由でHTTPSで動作しているアプリケーションに対して、送信されるヘッダを信頼するよう指示します。
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+#### Dockerキャッシュ
+
+この`Dockerfile`には重要なトリックがあり、まず**依存関係だけのファイル**をコピーします。その理由を説明します。
+
+```Dockerfile
+COPY ./requirements.txt /code/requirements.txt
+```
+
+Dockerや他のツールは、これらのコンテナイメージを**段階的に**ビルドし、**1つのレイヤーを他のレイヤーの上に**追加します。`Dockerfile`の先頭から開始し、`Dockerfile`の各命令によって作成されたファイルを追加していきます。
+
+Dockerや同様のツールは、イメージをビルドする際に**内部キャッシュ**も使用します。前回コンテナイメージを構築したときからファイルが変更されていない場合、ファイルを再度コピーしてゼロから新しいレイヤーを作成する代わりに、**前回作成した同じレイヤーを再利用**します。
+
+ただファイルのコピーを避けるだけではあまり改善されませんが、そのステップでキャッシュを利用したため、**次のステップ**でキャッシュを使うことができます。
+
+例えば、依存関係をインストールする命令のためにキャッシュを使うことができます：
+
+```Dockerfile
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+```
+
+パッケージ要件のファイルは**頻繁に変更されることはありません**。そのため、そのファイルだけをコピーすることで、Dockerはそのステップでは**キャッシュ**を使用することができます。
+
+そして、Dockerは**次のステップのためにキャッシュ**を使用し、それらの依存関係をダウンロードしてインストールすることができます。そして、ここで**多くの時間を節約**します。✨ ...そして退屈な待ち時間を避けることができます。😪😆
+
+パッケージの依存関係をダウンロードしてインストールするには**数分**かかりますが、**キャッシュ**を使えば**せいぜい数秒**です。
+
+加えて、開発中にコンテナ・イメージを何度もビルドして、コードの変更が機能しているかどうかをチェックすることになるため、多くの時間を節約することができます。
+
+そして`Dockerfile`の最終行の近くですべてのコードをコピーします。この理由は、**最も頻繁に**変更されるものなので、このステップの後にあるものはほとんどキャッシュを使用することができないのためです。
+
+```Dockerfile
+COPY ./app /code/app
+```
+
+### Dockerイメージをビルドする
+
+すべてのファイルが揃ったので、コンテナ・イメージをビルドしましょう。
+
+* プロジェクトディレクトリに移動します（`Dockerfile`がある場所で、`app`ディレクトリがあります）
+* FastAPI イメージをビルドします：
 
 <div class="termy">
 
@@ -106,9 +305,14 @@ $ docker build -t myimage .
 
 </div>
 
-## Dockerコンテナを起動
+!!! tip
+   末尾の `.` に注目してほしいです。これは `./` と同じ意味です。 これはDockerにコンテナイメージのビルドに使用するディレクトリを指示します。
 
-* 用意したイメージを基にしたコンテナの起動:
+    この場合、同じカレント・ディレクトリ(`.`)です。
+
+### Dockerコンテナの起動する
+
+* イメージに基づいてコンテナを実行します：
 
 <div class="termy">
 
@@ -118,62 +322,394 @@ $ docker run -d --name mycontainer -p 80:80 myimage
 
 </div>
 
-これで、Dockerコンテナ内に最適化されたFastAPIサーバが動作しています。使用しているサーバ (そしてCPUコア数) に沿った自動チューニングが行われています。
+## 確認する
 
-## 確認
+Dockerコンテナの<a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> や <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (またはそれに相当するDockerホストを使用したもの）といったURLで確認できるはずです。
 
-DockerコンテナのURLで確認できるはずです。例えば: <a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> や <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (もしくはDockerホストを使用したこれらと同等のもの)。
-
-以下の様なものが返されます:
+アクセスすると以下のようなものが表示されます：
 
 ```JSON
 {"item_id": 5, "q": "somequery"}
 ```
 
-## 対話的APIドキュメント
+## インタラクティブなAPIドキュメント
 
-ここで、<a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> や <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (もしくはDockerホストを使用したこれらと同等のもの) を開いて下さい。
+これらのURLにもアクセスできます:  <a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> や <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (またはそれに相当するDockerホストを使用したもの）
 
-自動生成された対話的APIドキュメントが確認できます (<a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>によって提供されます):
+アクセスすると、自動対話型APIドキュメント（<a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>が提供）が表示されます：
 
 ![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
 
-## その他のAPIドキュメント
+## 代替のAPIドキュメント
 
-また同様に、<a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> や <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (もしくはDockerホストを使用したこれらと同等のもの) を開いて下さい。
+また、<a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> や <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (またはそれに相当するDockerホストを使用したもの）にもアクセスできます。
 
-他の自動生成された対話的なAPIドキュメントが確認できます (<a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>によって提供されます):
+代替の自動ドキュメント（<a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>によって提供される）が表示されます：
 
 ![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
 
-## Traefik
+## 単一ファイルのFastAPIでDockerイメージをビルドする
 
-<a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>は、高性能なリバースプロキシ/ロードバランサーです。「TLSターミネーションプロキシ」ジョブを実行できます（他の機能と切り離して）。
+FastAPI が単一のファイル、例えば `./app` ディレクトリのない `main.py` の場合、ファイル構造は次のようになります：
+```
+.
+├── Dockerfile
+├── main.py
+└── requirements.txt
+```
 
-Let's Encryptと統合されています。そのため、証明書の取得と更新を含むHTTPSに関するすべての処理を実行できます。
+そうすれば、`Dockerfile`の中にファイルをコピーするために、対応するパスを変更するだけでよいです：
 
-また、Dockerとも統合されています。したがって、各アプリケーション構成でドメインを宣言し、それらの構成を読み取って、HTTPS証明書を生成し、構成に変更を加えることなく、アプリケーションにHTTPSを自動的に提供できます。
+```{ .dockerfile .annotate hl_lines="10  13" }
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (1)
+COPY ./main.py /code/
+
+# (2)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. main.py`ファイルを `/code` ディレクトリに直接コピーします。
+
+2. Uvicornを実行し、`main`から`app`オブジェクトをインポートするように指示します（`app.main`からインポートするのではなく）。
+
+次にUvicornコマンドを調整して、`app.main` の代わりに新しいモジュール `main` を使用し、FastAPIオブジェクトである `app` をインポートします。
+
+## デプロイメントのコンセプト
+
+コンテナという観点から、[デプロイのコンセプト](./concepts.md){.internal-link target=_blank}に共通するいくつかについて、もう一度説明しましょう。
+
+コンテナは主に、アプリケーションの**ビルドとデプロイ**のプロセスを簡素化するためのツールですが、これらの**デプロイのコンセプト**を扱うための特定のアプローチを強制するものではないです。
+
+**良いニュース**は、それぞれの異なる戦略には、すべてのデプロイメントのコンセプトをカバーする方法があるということです。🎉
+
+これらの**デプロイメントのコンセプト**をコンテナの観点から見直してみましょう：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
+
+## HTTPS
+
+FastAPI アプリケーションの **コンテナ・イメージ**（および後で実行中の **コンテナ**）だけに焦点を当てると、通常、HTTPSは別のツールを用いて**外部で**処理されます。
+
+例えば<a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>のように、**HTTPS**と**証明書**の**自動**取得を扱う別のコンテナである可能性もあります。
+
+!!! tip
+    TraefikはDockerやKubernetesなどと統合されているので、コンテナ用のHTTPSの設定や構成はとても簡単です。
+
+あるいは、（コンテナ内でアプリケーションを実行しながら）クラウド・プロバイダーがサービスの1つとしてHTTPSを処理することもできます。
+
+## 起動時および再起動時の実行
+
+通常、コンテナの**起動と実行**を担当する別のツールがあります。
+
+それは直接**Docker**であったり、**Docker Compose**であったり、**Kubernetes**であったり、**クラウドサービス**であったりします。
+
+ほとんどの場合（またはすべての場合）、起動時にコンテナを実行し、失敗時に再起動を有効にする簡単なオプションがあります。例えばDockerでは、コマンドラインオプションの`--restart`が該当します。
+
+コンテナを使わなければ、アプリケーションを起動時や再起動時に実行させるのは面倒で難しいかもしれません。しかし、**コンテナ**で作業する場合、ほとんどのケースでその機能はデフォルトで含まれています。✨
+
+## レプリケーション - プロセス数
+
+**Kubernetes** や Docker Swarm モード、Nomad、あるいは複数のマシン上で分散コンテナを管理するための同様の複雑なシステムを使ってマシンの<abbr title="何らかの方法で接続され、一緒に動作するように構成されたマシンのグループ">クラスター</abbr>を構成している場合、 各コンテナで（Workerを持つGunicornのような）**プロセスマネージャ**を使用する代わりに、**クラスター・レベル**で**レプリケーション**を処理したいと思うでしょう。
+
+Kubernetesのような分散コンテナ管理システムの1つは通常、入ってくるリクエストの**ロードバランシング**をサポートしながら、**コンテナのレプリケーション**を処理する統合された方法を持っています。このことはすべて**クラスタレベル**にてです。
+
+そのような場合、UvicornワーカーでGunicornのようなものを実行するのではなく、[上記の説明](#dockerfile)のように**Dockerイメージをゼロから**ビルドし、依存関係をインストールして、**単一のUvicornプロセス**を実行したいでしょう。
+
+### ロードバランサー
+
+コンテナを使用する場合、通常はメイン・ポート**でリスニング**しているコンポーネントがあるはずです。それはおそらく、**HTTPS**を処理するための**TLS Termination Proxy**でもある別のコンテナであったり、同様のツールであったりするでしょう。
+
+このコンポーネントはリクエストの **負荷** を受け、 (うまくいけば) その負荷を**バランスよく** ワーカーに分配するので、一般に **ロードバランサ** とも呼ばれます。
+
+!!! tip
+　　HTTPSに使われるものと同じ**TLS Termination Proxy**コンポーネントは、おそらく**ロードバランサー**にもなるでしょう。
+
+そしてコンテナで作業する場合、コンテナの起動と管理に使用する同じシステムには、**ロードバランサー**（**TLS Termination Proxy**の可能性もある）から**ネットワーク通信**（HTTPリクエストなど）をアプリのあるコンテナ（複数可）に送信するための内部ツールが既にあるはずです。
+
+### 1つのロードバランサー - 複数のワーカーコンテナー
+
+**Kubernetes**や同様の分散コンテナ管理システムで作業する場合、その内部のネットワーキングのメカニズムを使用することで、メインの**ポート**でリッスンしている単一の**ロードバランサー**が、アプリを実行している可能性のある**複数のコンテナ**に通信（リクエスト）を送信できるようになります。
+
+アプリを実行するこれらのコンテナには、通常**1つのプロセス**（たとえば、FastAPIアプリケーションを実行するUvicornプロセス）があります。これらはすべて**同一のコンテナ**であり同じものを実行しますが、それぞれが独自のプロセスやメモリなどを持ちます。そうすることで、CPUの**異なるコア**、あるいは**異なるマシン**での**並列化**を利用できます。
+
+そして、**ロードバランサー**を備えた分散コンテナシステムは、**順番に**あなたのアプリを含む各コンテナに**リクエストを分配**します。つまり、各リクエストは、あなたのアプリを実行している複数の**レプリケートされたコンテナ**の1つによって処理されます。
+
+そして通常、この**ロードバランサー**は、クラスタ内の*他の*アプリケーション（例えば、異なるドメインや異なるURLパスのプレフィックスの配下）へのリクエストを処理することができ、その通信をクラスタ内で実行されている*他の*アプリケーションのための適切なコンテナに送信します。
+
+### 1コンテナにつき1プロセス
+
+この種のシナリオでは、すでにクラスタ・レベルでレプリケーションを処理しているため、おそらくコンテナごとに**単一の（Uvicorn）プロセス**を持ちたいでしょう。
+
+この場合、Uvicornワーカーを持つGunicornのようなプロセスマネージャーや、Uvicornワーカーを使うUvicornは**避けたい**でしょう。**コンテナごとにUvicornのプロセスは1つだけ**にしたいでしょう（おそらく複数のコンテナが必要でしょう）。
+
+（GunicornやUvicornがUvicornワーカーを管理するように）コンテナ内に別のプロセスマネージャーを持つことは、クラスターシステムですでに対処しているであろう**不要な複雑さ**を追加するだけです。
+
+### Containers with Multiple Processes and Special Cases
+
+もちろん、**特殊なケース**として、**Gunicornプロセスマネージャ**を持つ**コンテナ**内で複数の**Uvicornワーカープロセス**を起動させたい場合があります。
+
+このような場合、**公式のDockerイメージ**を使用することができます。このイメージには、複数の**Uvicornワーカープロセス**を実行するプロセスマネージャとして**Gunicorn**が含まれており、現在のCPUコアに基づいてワーカーの数を自動的に調整するためのデフォルト設定がいくつか含まれています。詳しくは後述の[Gunicornによる公式Dockerイメージ - Uvicorn](#gunicornによる公式dockerイメージ---Uvicorn)で説明します。
+
+以下は、それが理にかなっている場合の例です：
+
+#### シンプルなアプリケーション
+
+アプリケーションを**シンプル**な形で実行する場合、プロセス数の細かい調整が必要ない場合、自動化されたデフォルトを使用するだけで、コンテナ内にプロセスマネージャが必要かもしれません。例えば、公式Dockerイメージでシンプルな設定が可能です。
+
+#### Docker Compose
+
+Docker Composeで**シングルサーバ**（クラスタではない）にデプロイすることもできますので、共有ネットワークと**ロードバランシング**を維持しながら（Docker Composeで）コンテナのレプリケーションを管理する簡単な方法はないでしょう。
+
+その場合、**単一のコンテナ**で、**プロセスマネージャ**が内部で**複数のワーカープロセス**を起動するようにします。
+
+#### Prometheusとその他の理由
+
+また、**1つのコンテナ**に**1つのプロセス**を持たせるのではなく、**1つのコンテナ**に**複数のプロセス**を持たせる方が簡単だという**他の理由**もあるでしょう。
+
+例えば、(セットアップにもよりますが)Prometheusエクスポーターのようなツールを同じコンテナ内に持つことができます。
+
+この場合、**複数のコンテナ**があると、デフォルトでは、Prometheusが**メトリクスを**読みに来たとき、すべてのレプリケートされたコンテナの**蓄積されたメトリクス**を取得するのではなく、毎回**単一のコンテナ**（その特定のリクエストを処理したコンテナ）のものを取得することになります。
+
+その場合、**複数のプロセス**を持つ**1つのコンテナ**を用意し、同じコンテナ上のローカルツール（例えばPrometheusエクスポーター）がすべての内部プロセスのPrometheusメトリクスを収集し、その1つのコンテナ上でそれらのメトリクスを公開する方がシンプルかもしれません。
 
 ---
 
-次のセクションに進み、この情報とツールを使用して、すべてを組み合わせます。
+重要なのは、盲目的に従わなければならない普遍のルールはないということです。
 
-## TraefikとHTTPSを使用したDocker Swarmモードのクラスタ
+これらのアイデアは、**あなた自身のユースケース**を評価し、あなたのシステムに最適なアプローチを決定するために使用することができます：
 
-HTTPSを処理する（証明書の取得と更新を含む）Traefikを使用して、Docker Swarmモードのクラスタを数分（20分程度）でセットアップできます。
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
 
-Docker Swarmモードを使用することで、1台のマシンの「クラスタ」から開始でき（1か月あたり5ドルのサーバーでもできます）、後から必要なだけサーバーを拡張できます。
+## メモリー
 
-TraefikおよびHTTPS処理を備えたDocker Swarm Modeクラスターをセットアップするには、次のガイドに従います:
+コンテナごとに**単一のプロセスを実行する**と、それらのコンテナ（レプリケートされている場合は1つ以上）によって消費される多かれ少なかれ明確に定義された、安定し制限された量のメモリを持つことになります。
 
-### <a href="https://medium.com/@tiangolo/docker-swarm-mode-and-traefik-for-a-https-cluster-20328dba6232" class="external-link" target="_blank">Docker Swarm Mode and Traefik for an HTTPS cluster</a>
+そして、コンテナ管理システム（**Kubernetes**など）の設定で、同じメモリ制限と要件を設定することができます。
 
-### FastAPIアプリケーションのデプロイ
+そうすれば、コンテナが必要とするメモリ量とクラスタ内のマシンで利用可能なメモリ量を考慮して、**利用可能なマシン**に**コンテナ**をレプリケートできるようになります。
 
-すべてを設定するための最も簡単な方法は、[**FastAPI** Project Generators](../project-generation.md){.internal-link target=_blank}を使用することでしょう。
+アプリケーションが**シンプル**なものであれば、これはおそらく**問題にはならない**でしょうし、ハードなメモリ制限を指定する必要はないかもしれないです。
 
-上述したTraefikとHTTPSを備えたDocker Swarm クラスタが統合されるように設計されています。
+しかし、**多くのメモリを使用**している場合（たとえば**機械学習**モデルなど）、どれだけのメモリを消費しているかを確認し、**各マシンで実行するコンテナの数**を調整する必要があります（そしておそらくクラスタにマシンを追加します）。
 
-2分程度でプロジェクトが生成されます。
+**コンテナごとに複数のプロセス**を実行する場合（たとえば公式のDockerイメージで）、起動するプロセスの数が**利用可能なメモリ以上に消費しない**ようにする必要があります。
 
-生成されたプロジェクトはデプロイの指示がありますが、それを実行するとさらに2分かかります。
+## 開始前の事前ステップとコンテナ
+
+コンテナ（DockerやKubernetesなど）を使っている場合、主に2つのアプローチがあります。
+
+### 複数のコンテナ
+
+複数の**コンテナ**があり、おそらくそれぞれが**単一のプロセス**を実行している場合（**Kubernetes**クラスタなど）、レプリケートされたワーカーコンテナを実行する**前に**、単一のコンテナで**事前のステップ**の作業を行う**別のコンテナ**を持ちたいと思うでしょう。
+
+!!! info
+    もしKubernetesを使用している場合, これはおそらく<a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Init コンテナ</a>でしょう。
+
+ユースケースが事前のステップを**並列で複数回**実行するのに問題がない場合（例：データベースの準備チェック）、メインプロセスを開始する前に、それらのステップを各コンテナに入れることが可能です。
+
+### 単一コンテナ
+
+単純なセットアップで、**単一のコンテナ**で複数の**ワーカー・プロセス**（または1つのプロセスのみ）を起動する場合、アプリでプロセスを開始する直前に、同じコンテナで事前のステップを実行できます。公式Dockerイメージは、内部的にこれをサポートしています。
+
+## Gunicornによる公式Dockerイメージ - Uvicorn
+
+前の章で詳しく説明したように、Uvicornワーカーで動作するGunicornを含む公式のDockerイメージがあります： [Server Workers - Gunicorn と Uvicorn](./server-workers.md){.internal-link target=_blank}で詳しく説明しています。
+
+このイメージは、主に上記で説明した状況で役に立つでしょう： [複数のプロセスと特殊なケースを持つコンテナ（Containers with Multiple Processes and Special Cases）](#containers-with-multiple-processes-and-special-cases)
+
+* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+
+!!! warning
+    このベースイメージや類似のイメージは**必要ない**可能性が高いので、[上記の: FastAPI用のDockerイメージをビルドする（Build a Docker Image for FastAPI）](#build-a-docker-image-for-fastapi)のようにゼロからイメージをビルドする方が良いでしょう。
+
+このイメージには、利用可能なCPUコアに基づいて**ワーカー・プロセスの数**を設定する**オートチューニング**メカニズムが含まれています。
+
+これは**賢明なデフォルト**を備えていますが、**環境変数**や設定ファイルを使ってすべての設定を変更したり更新したりすることができます。
+
+また、スクリプトで<a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**開始前の事前ステップ**</a>を実行することもサポートしている。
+
+!!! tip
+    すべての設定とオプションを見るには、Dockerイメージのページをご覧ください: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>
+
+### 公式Dockerイメージのプロセス数
+
+このイメージの**プロセス数**は、利用可能なCPU**コア**から**自動的に計算**されます。
+
+つまり、CPUから可能な限り**パフォーマンス**を**引き出そう**とします。
+
+また、**環境変数**などを使った設定で調整することもできます。
+
+しかし、プロセスの数はコンテナが実行しているCPUに依存するため、**消費されるメモリの量**もそれに依存することになります。
+
+そのため、（機械学習モデルなどで）大量のメモリを消費するアプリケーションで、サーバーのCPUコアが多いが**メモリが少ない**場合、コンテナは利用可能なメモリよりも多くのメモリを使おうとすることになります。
+
+その結果、パフォーマンスが大幅に低下する（あるいはクラッシュする）可能性があります。🚨
+
+### Dockerfileを作成する
+
+この画像に基づいて`Dockerfile`を作成する方法を以下に示します：
+
+```Dockerfile
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app
+```
+
+### より大きなアプリケーション
+
+[複数のファイルを持つ大きなアプリケーション](../tutorial/bigger-applications.md){.internal-link target=_blank}を作成するセクションに従った場合、`Dockerfile`は次のようになります：
+
+```Dockerfile hl_lines="7"
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app/app
+```
+
+### いつ使うのか
+
+おそらく、**Kubernetes**（または他のもの）を使用していて、すでにクラスタレベルで複数の**コンテナ**で**レプリケーション**を設定している場合は、この公式ベースイメージ（または他の類似のもの）は**使用すべきではありません**。
+
+そのような場合は、上記のように**ゼロから**イメージを構築する方がよいでしょう： [FastAPI用のDockerイメージをビルドする（Build a Docker Image for FastAPI）](#build-a-docker-image-for-fastapi) を参照してください。
+
+このイメージは、主に上記の[複数のプロセスと特殊なケースを持つコンテナ（Containers with Multiple Processes and Special Cases）](#containers-with-multiple-processes-and-special-cases)で説明したような特殊なケースで役に立ちます。
+
+例えば、アプリケーションが**シンプル**で、CPUに応じたデフォルトのプロセス数を設定すればうまくいく場合や、クラスタレベルでレプリケーションを手動で設定する手間を省きたい場合、アプリで複数のコンテナを実行しない場合などです。
+
+または、**Docker Compose**でデプロイし、単一のサーバで実行している場合などです。
+
+## コンテナ・イメージのデプロイ
+
+コンテナ（Docker）イメージを手に入れた後、それをデプロイするにはいくつかの方法があります。
+
+例えば以下のリストの方法です:
+
+* 単一サーバーの**Docker Compose**
+* **Kubernetes**クラスタ
+* Docker Swarmモードのクラスター
+* Nomadのような別のツール
+* コンテナ・イメージをデプロイするクラウド・サービス
+
+## Poetryを利用したDockerイメージ
+
+もしプロジェクトの依存関係を管理するために<a href="https://python-poetry.org/" class="external-link" target="_blank">Poetry</a>を利用する場合、マルチステージビルドを使うと良いでしょう。
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9 as requirements-stage
+
+# (2)
+WORKDIR /tmp
+
+# (3)
+RUN pip install poetry
+
+# (4)
+COPY ./pyproject.toml ./poetry.lock* /tmp/
+
+# (5)
+RUN poetry export -f requirements.txt --output requirements.txt --without-hashes
+
+# (6)
+FROM python:3.9
+
+# (7)
+WORKDIR /code
+
+# (8)
+COPY --from=requirements-stage /tmp/requirements.txt /code/requirements.txt
+
+# (9)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (10)
+COPY ./app /code/app
+
+# (11)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. これは最初のステージで、`requirements-stage`と名付けられます
+2. `/tmp` を現在の作業ディレクトリに設定します
+    ここで `requirements.txt` というファイルを生成します。
+
+3. このDockerステージにPoetryをインストールします
+
+4. pyproject.toml`と`poetry.lock`ファイルを`/tmp` ディレクトリにコピーします
+
+    `./poetry.lock*`（末尾に`*`）を使用するため、そのファイルがまだ利用できない場合でもクラッシュすることはないです。
+5. requirements.txt`ファイルを生成します
+
+6. これは最後のステージであり、ここにあるものはすべて最終的なコンテナ・イメージに保存されます
+7. 現在の作業ディレクトリを `/code` に設定します
+8. `requirements.txt`ファイルを `/code` ディレクトリにコピーします
+    このファイルは前のDockerステージにしか存在しないため、`--from-requirements-stage`を使ってコピーします。
+9. 生成された `requirements.txt` ファイルにあるパッケージの依存関係をインストールします
+10. app` ディレクトリを `/code` ディレクトリにコピーします
+11. uvicorn` コマンドを実行して、`app.main` からインポートした `app` オブジェクトを使用するように指示します
+!!! tip
+    "+"の吹き出しをクリックすると、それぞれの行が何をするのかを見ることができます
+
+**Dockerステージ**は`Dockerfile`の一部で、**一時的なコンテナイメージ**として動作します。
+
+最初のステージは **Poetryのインストール**と Poetry の `pyproject.toml` ファイルからプロジェクトの依存関係を含む**`requirements.txt`を生成**するためだけに使用されます。
+
+この `requirements.txt` ファイルは後半の **次のステージ**で `pip` と共に使用されます。
+
+最終的なコンテナイメージでは、**最終ステージ**のみが保存されます。前のステージは破棄されます。
+
+Poetryを使用する場合、**Dockerマルチステージビルド**を使用することは理にかなっています。
+
+なぜなら、最終的なコンテナイメージにPoetryとその依存関係がインストールされている必要はなく、**必要なのは**プロジェクトの依存関係をインストールするために生成された `requirements.txt` ファイルだけだからです。
+
+そして次の（そして最終的な）ステージでは、前述とほぼ同じ方法でイメージをビルドします。
+
+### TLS Termination Proxyの裏側 - Poetry
+
+繰り返しになりますが、NginxやTraefikのようなTLS Termination Proxy（ロードバランサー）の後ろでコンテナを動かしている場合は、`--proxy-headers`オプションをコマンドに追加します：
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+## まとめ
+
+コンテナ・システム（例えば**Docker**や**Kubernetes**など）を使えば、すべての**デプロイメントのコンセプト**を扱うのがかなり簡単になります：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
+
+ほとんどの場合、ベースとなるイメージは使用せず、公式のPython Dockerイメージをベースにした**コンテナイメージをゼロからビルド**します。
+
+`Dockerfile`と**Dockerキャッシュ**内の命令の**順番**に注意することで、**ビルド時間を最小化**することができ、生産性を最大化することができます（そして退屈を避けることができます）。😎
+
+特別なケースでは、FastAPI用の公式Dockerイメージを使いたいかもしれません。🤓
diff --git a/docs/ja/docs/deployment/https.md b/docs/ja/docs/deployment/https.md
new file mode 100644
index 000000000..a291f870f
--- /dev/null
+++ b/docs/ja/docs/deployment/https.md
@@ -0,0 +1,200 @@
+# HTTPS について
+
+HTTPSは単に「有効」か「無効」かで決まるものだと思いがちです。
+
+しかし、それよりもはるかに複雑です。
+
+!!! tip
+    もし急いでいたり、HTTPSの仕組みについて気にしないのであれば、次のセクションに進み、さまざまなテクニックを使ってすべてをセットアップするステップ・バイ・ステップの手順をご覧ください。
+
+利用者の視点から **HTTPS の基本を学ぶ**に当たっては、次のリソースをオススメします: <a href="https://howhttps.works/" class="external-link" target="_blank">https://howhttps.works/</a>.
+
+さて、**開発者の視点**から、HTTPSについて考える際に念頭に置くべきことをいくつかみていきましょう：
+
+* HTTPSの場合、**サーバ**は**第三者**によって生成された**「証明書」を持つ**必要があります。
+    * これらの証明書は「生成」されたものではなく、実際には第三者から**取得**されたものです。
+* 証明書には**有効期限**があります。
+    * つまりいずれ失効します。
+    * そのため**更新**をし、第三者から**再度取得**する必要があります。
+* 接続の暗号化は**TCPレベル**で行われます。
+    * それは**HTTPの1つ下**のレイヤーです。
+    * つまり、**証明書と暗号化**の処理は、**HTTPの前**に行われます。
+* **TCPは "ドメイン "について知りません**。IPアドレスについてのみ知っています。
+    * 要求された**特定のドメイン**に関する情報は、**HTTPデータ**に入ります。
+* **HTTPS証明書**は、**特定のドメイン**を「証明」しますが、プロトコルと暗号化はTCPレベルで行われ、どのドメインが扱われているかを**知る前**に行われます。
+* **デフォルトでは**、**IPアドレスごとに1つのHTTPS証明書**しか持てないことになります。
+    * これは、サーバーの規模やアプリケーションの規模に寄りません。
+    * しかし、これには**解決策**があります。
+* **TLS**プロトコル(HTTPの前に、TCPレベルで暗号化を処理するもの)には、**<a href="https://en.wikipedia.org/wiki/Server_Name_Indication" class="external-link" target="_blank"><abbr title="サーバー名表示">SNI</abbr></a>**と呼ばれる**拡張**があります。
+    * このSNI拡張機能により、1つのサーバー（**単一のIPアドレス**を持つ）が**複数のHTTPS証明書**を持ち、**複数のHTTPSドメイン/アプリケーション**にサービスを提供できるようになります。
+    * これが機能するためには、**パブリックIPアドレス**でリッスンしている、サーバー上で動作している**単一の**コンポーネント(プログラム)が、サーバー内の**すべてのHTTPS証明書**を持っている必要があります。
+
+* セキュアな接続を取得した**後**でも、通信プロトコルは**HTTPのまま**です。
+    * コンテンツは**HTTPプロトコル**で送信されているにもかかわらず、**暗号化**されています。
+
+
+サーバー（マシン、ホストなど）上で**1つのプログラム/HTTPサーバー**を実行させ、**HTTPSに関する全てのこと**を管理するのが一般的です。
+
+**暗号化された HTTPS リクエスト** を受信し、**復号化された HTTP リクエスト** を同じサーバーで実行されている実際の HTTP アプリケーション（この場合は **FastAPI** アプリケーション）に送信し、アプリケーションから **HTTP レスポンス** を受け取り、適切な **HTTPS 証明書** を使用して **暗号化** し、そして**HTTPS** を使用してクライアントに送り返します。
+
+このサーバーはしばしば **<a href="https://en.wikipedia.org/wiki/TLS_termination_proxy" class="external-link" target="_blank">TLS Termination Proxy</a>**と呼ばれます。
+
+TLS Termination Proxyとして使えるオプションには、以下のようなものがあります：
+
+* Traefik（証明書の更新も対応）
+* Caddy (証明書の更新も対応)
+* Nginx
+* HAProxy
+
+
+## Let's Encrypt
+
+Let's Encrypt以前は、これらの**HTTPS証明書**は信頼できる第三者によって販売されていました。
+
+これらの証明書を取得するための手続きは面倒で、かなりの書類を必要とし、証明書はかなり高価なものでした。
+
+しかしその後、**<a href="https://letsencrypt.org/" class="external-link" target="_blank">Let's Encrypt</a>** が作られました。
+
+これはLinux Foundationのプロジェクトから生まれたものです。 自動化された方法で、**HTTPS証明書を無料で**提供します。これらの証明書は、すべての標準的な暗号化セキュリティを使用し、また短命（約3ヶ月）ですが、こういった寿命の短さによって、**セキュリティは実際に優れています**。
+
+ドメインは安全に検証され、証明書は自動的に生成されます。また、証明書の更新も自動化されます。
+
+このアイデアは、これらの証明書の取得と更新を自動化することで、**安全なHTTPSを、無料で、永遠に**利用できるようにすることです。
+
+## 開発者のための HTTPS
+
+ここでは、HTTPS APIがどのように見えるかの例を、主に開発者にとって重要なアイデアに注意を払いながら、ステップ・バイ・ステップで説明します。
+
+### ドメイン名
+
+ステップの初めは、**ドメイン名**を**取得すること**から始まるでしょう。その後、DNSサーバー（おそらく同じクラウドプロバイダー）に設定します。
+
+おそらくクラウドサーバー（仮想マシン）かそれに類するものを手に入れ、<abbr title="変わらない">固定の</abbr> **パブリックIPアドレス**を持つことになるでしょう。
+
+DNSサーバーでは、**取得したドメイン**をあなたのサーバーのパプリック**IPアドレス**に向けるレコード（「`Aレコード`」）を設定します。
+
+これはおそらく、最初の1回だけあり、すべてをセットアップするときに行うでしょう。
+
+!!! tip
+    ドメイン名の話はHTTPSに関する話のはるか前にありますが、すべてがドメインとIPアドレスに依存するため、ここで言及する価値があります。
+
+### DNS
+
+では、実際のHTTPSの部分に注目してみよう。
+
+まず、ブラウザは**DNSサーバー**に**ドメインに対するIP**が何であるかを確認します。今回は、`someapp.example.com`とします。
+
+DNSサーバーは、ブラウザに特定の**IPアドレス**を使用するように指示します。このIPアドレスは、DNSサーバーで設定した、あなたのサーバーが使用するパブリックIPアドレスになります。
+
+<img src="/img/deployment/https/https01.svg">
+
+### TLS Handshake の開始
+
+ブラウザはIPアドレスと**ポート443**（HTTPSポート）で通信します。
+
+通信の最初の部分は、クライアントとサーバー間の接続を確立し、使用する暗号鍵などを決めるだけです。
+
+<img src="/img/deployment/https/https02.svg">
+
+TLS接続を確立するためのクライアントとサーバー間のこのやりとりは、**TLSハンドシェイク**と呼ばれます。
+
+### SNI拡張機能付きのTLS
+
+サーバー内の**1つのプロセス**だけが、特定 の**IPアドレス**の特定の**ポート** で待ち受けることができます。
+
+同じIPアドレスの他のポートで他のプロセスがリッスンしている可能性もありますが、IPアドレスとポートの組み合わせごとに1つだけです。
+
+TLS（HTTPS）はデフォルトで`443`という特定のポートを使用する。つまり、これが必要なポートです。
+
+このポートをリッスンできるのは1つのプロセスだけなので、これを実行するプロセスは**TLS Termination Proxy**となります。
+
+TLS Termination Proxyは、1つ以上の**TLS証明書**（HTTPS証明書）にアクセスできます。
+
+前述した**SNI拡張機能**を使用して、TLS Termination Proxy は、利用可能なTLS (HTTPS)証明書のどれを接続先として使用すべきかをチェックし、クライアントが期待するドメインに一致するものを使用します。
+
+今回は、`someapp.example.com`の証明書を使うことになります。
+
+<img src="/img/deployment/https/https03.svg">
+
+クライアントは、そのTLS証明書を生成したエンティティ（この場合はLet's Encryptですが、これについては後述します）をすでに**信頼**しているため、その証明書が有効であることを**検証**することができます。
+
+次に証明書を使用して、クライアントとTLS Termination Proxy は、 **TCP通信**の残りを**どのように暗号化するかを決定**します。これで**TLSハンドシェイク**の部分が完了します。
+
+この後、クライアントとサーバーは**暗号化されたTCP接続**を持ちます。そして、その接続を使って実際の**HTTP通信**を開始することができます。
+
+これが**HTTPS**であり、純粋な（暗号化されていない）TCP接続ではなく、**セキュアなTLS接続**の中に**HTTP**があるだけです。
+
+!!! tip
+    通信の暗号化は、HTTPレベルではなく、**TCPレベル**で行われることに注意してください。
+
+### HTTPS リクエスト
+
+これでクライアントとサーバー（具体的にはブラウザとTLS Termination Proxy）は**暗号化されたTCP接続**を持つことになり、**HTTP通信**を開始することができます。
+
+そこで、クライアントは**HTTPSリクエスト**を送信します。これは、暗号化されたTLSコネクションを介した単なるHTTPリクエストです。
+
+<img src="/img/deployment/https/https04.svg">
+
+### リクエストの復号化
+
+TLS Termination Proxy は、合意が取れている暗号化を使用して、**リクエストを復号化**し、**プレーン (復号化された) HTTP リクエスト** をアプリケーションを実行しているプロセス (例えば、FastAPI アプリケーションを実行している Uvicorn を持つプロセス) に送信します。
+
+<img src="/img/deployment/https/https05.svg">
+
+### HTTP レスポンス
+
+アプリケーションはリクエストを処理し、**プレーン(暗号化されていない)HTTPレスポンス** をTLS Termination Proxyに送信します。
+
+<img src="/img/deployment/https/https06.svg">
+
+### HTTPS レスポンス
+
+TLS Termination Proxyは次に、事前に合意が取れている暗号(`someapp.example.com`の証明書から始まる)を使って**レスポンスを暗号化し**、ブラウザに送り返す。
+
+その後ブラウザでは、レスポンスが有効で正しい暗号キーで暗号化されていることなどを検証します。そして、ブラウザはレスポンスを**復号化**して処理します。
+
+<img src="/img/deployment/https/https07.svg">
+
+クライアント（ブラウザ）は、レスポンスが正しいサーバーから来たことを知ることができます。 なぜなら、そのサーバーは、以前に**HTTPS証明書**を使って合意した暗号を使っているからです。
+
+### 複数のアプリケーション
+
+同じサーバー（または複数のサーバー）に、例えば他のAPIプログラムやデータベースなど、**複数のアプリケーション**が存在する可能性があります。
+
+特定のIPとポート（この例ではTLS Termination Proxy）を扱うことができるのは1つのプロセスだけですが、他のアプリケーション/プロセスも、同じ**パブリックIPとポート**の組み合わせを使用しようとしない限り、サーバー上で実行することができます。
+
+<img src="/img/deployment/https/https08.svg">
+
+そうすれば、TLS Termination Proxy は、**複数のドメイン**や複数のアプリケーションのHTTPSと証明書を処理し、それぞれのケースで適切なアプリケーションにリクエストを送信することができます。
+
+### 証明書の更新
+
+将来のある時点で、各証明書は（取得後約3ヶ月で）**失効**します。
+
+その後、Let's Encryptと通信する別のプログラム（別のプログラムである場合もあれば、同じTLS Termination Proxyである場合もある）によって、証明書を更新します。
+
+<img src="/img/deployment/https/https.svg">
+
+**TLS証明書**は、IPアドレスではなく、**ドメイン名に関連付けられて**います。
+
+したがって、証明書を更新するために、更新プログラムは、認証局（Let's Encrypt）に対して、**そのドメインが本当に「所有」し、管理している**ことを**証明**する必要があります。
+
+そのために、またさまざまなアプリケーションのニーズに対応するために、いくつかの方法があります。よく使われる方法としては:
+
+* **いくつかのDNSレコードを修正します。**
+    * これをするためには、更新プログラムはDNSプロバイダーのAPIをサポートする必要があります。したがって、使用しているDNSプロバイダーによっては、このオプションが使える場合もあれば、使えない場合もあります。
+* ドメインに関連付けられたパブリックIPアドレス上で、（少なくとも証明書取得プロセス中は）**サーバー**として実行します。
+    * 上で述べたように、特定のIPとポートでリッスンできるプロセスは1つだけです。
+    * これは、同じTLS Termination Proxyが証明書の更新処理も行う場合に非常に便利な理由の1つです。
+    * そうでなければ、TLS Termination Proxyを一時的に停止し、証明書を取得するために更新プログラムを起動し、TLS Termination Proxyで証明書を設定し、TLS Termination Proxyを再起動しなければならないかもしれません。TLS Termination Proxyが停止している間はアプリが利用できなくなるため、これは理想的ではありません。
+
+
+アプリを提供しながらこのような更新処理を行うことは、アプリケーション・サーバー（Uvicornなど）でTLS証明書を直接使用するのではなく、TLS Termination Proxyを使用して**HTTPSを処理する別のシステム**を用意したくなる主な理由の1つです。
+
+## まとめ
+
+**HTTPS**を持つことは非常に重要であり、ほとんどの場合、かなり**クリティカル**です。開発者として HTTPS に関わる労力のほとんどは、これらの**概念とその仕組みを理解する**ことです。
+
+しかし、ひとたび**開発者向けHTTPS**の基本的な情報を知れば、簡単な方法ですべてを管理するために、さまざまなツールを組み合わせて設定することができます。
+
+次の章では、**FastAPI** アプリケーションのために **HTTPS** をセットアップする方法について、いくつかの具体例を紹介します。🔒
diff --git a/docs/ja/docs/deployment/server-workers.md b/docs/ja/docs/deployment/server-workers.md
new file mode 100644
index 000000000..e1ea165a2
--- /dev/null
+++ b/docs/ja/docs/deployment/server-workers.md
@@ -0,0 +1,182 @@
+# Server Workers - Gunicorn と Uvicorn
+
+前回のデプロイメントのコンセプトを振り返ってみましょう：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
+
+ここまでのドキュメントのチュートリアルでは、おそらくUvicornのような**サーバープログラム**を**単一のプロセス**で実行しています。
+
+アプリケーションをデプロイする際には、**複数のコア**を利用し、そしてより多くのリクエストを処理できるようにするために、プロセスの**レプリケーション**を持つことを望むでしょう。
+
+前のチャプターである[デプロイメントのコンセプト](./concepts.md){.internal-link target=_blank}にて見てきたように、有効な戦略がいくつかあります。
+
+ここでは<a href="https://gunicorn.org/" class="external-link" target="_blank">**Gunicorn**</a>が**Uvicornのワーカー・プロセス**を管理する場合の使い方について紹介していきます。
+
+!!! info
+    <!-- NOTE: the current version of docker.md is outdated compared to English one.  -->
+    DockerやKubernetesなどのコンテナを使用している場合は、次の章で詳しく説明します： [コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}
+
+    特に**Kubernetes**上で実行する場合は、おそらく**Gunicornを使用せず**、**コンテナごとに単一のUvicornプロセス**を実行することになりますが、それについてはこの章の後半で説明します。
+
+## GunicornによるUvicornのワーカー・プロセスの管理
+
+**Gunicorn**は**WSGI標準**のアプリケーションサーバーです。このことは、GunicornはFlaskやDjangoのようなアプリケーションにサービスを提供できることを意味します。Gunicornそれ自体は**FastAPI**と互換性がないですが、というのもFastAPIは最新の**<a href="https://asgi.readthedocs.io/en/latest/" class="external-link" target="_blank">ASGI 標準</a>**を使用しているためです。
+
+しかし、Gunicornは**プロセスマネージャー**として動作し、ユーザーが特定の**ワーカー・プロセスクラス**を使用するように指示することができます。するとGunicornはそのクラスを使い1つ以上の**ワーカー・プロセス**を開始します。
+
+そして**Uvicorn**には**Gunicorn互換のワーカークラス**があります。
+
+この組み合わせで、Gunicornは**プロセスマネージャー**として動作し、**ポート**と**IP**をリッスンします。そして、**Uvicornクラス**を実行しているワーカー・プロセスに通信を**転送**します。
+
+そして、Gunicorn互換の**Uvicornワーカー**クラスが、FastAPIが使えるように、Gunicornから送られてきたデータをASGI標準に変換する役割を担います。
+
+## GunicornとUvicornをインストールする
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]" gunicorn
+
+---> 100%
+```
+
+</div>
+
+これによりUvicornと（高性能を得るための）標準（`standard`）の追加パッケージとGunicornの両方がインストールされます。
+
+## UvicornのワーカーとともにGunicornを実行する
+
+Gunicornを以下のように起動させることができます:
+
+<div class="termy">
+
+```console
+$ gunicorn main:app --workers 4 --worker-class uvicorn.workers.UvicornWorker --bind 0.0.0.0:80
+
+[19499] [INFO] Starting gunicorn 20.1.0
+[19499] [INFO] Listening at: http://0.0.0.0:80 (19499)
+[19499] [INFO] Using worker: uvicorn.workers.UvicornWorker
+[19511] [INFO] Booting worker with pid: 19511
+[19513] [INFO] Booting worker with pid: 19513
+[19514] [INFO] Booting worker with pid: 19514
+[19515] [INFO] Booting worker with pid: 19515
+[19511] [INFO] Started server process [19511]
+[19511] [INFO] Waiting for application startup.
+[19511] [INFO] Application startup complete.
+[19513] [INFO] Started server process [19513]
+[19513] [INFO] Waiting for application startup.
+[19513] [INFO] Application startup complete.
+[19514] [INFO] Started server process [19514]
+[19514] [INFO] Waiting for application startup.
+[19514] [INFO] Application startup complete.
+[19515] [INFO] Started server process [19515]
+[19515] [INFO] Waiting for application startup.
+[19515] [INFO] Application startup complete.
+```
+
+</div>
+
+それぞれのオプションの意味を見てみましょう：
+
+* `main:app`： `main`は"`main`"という名前のPythonモジュール、つまりファイル`main.py`を意味します。そして `app` は **FastAPI** アプリケーションの変数名です。
+    * main:app`はPythonの`import`文と同じようなものだと想像できます：
+
+        ```Python
+        from main import app
+        ```
+
+    * つまり、`main:app`のコロンは、`from main import app`のPythonの`import`の部分と同じになります。
+
+* `--workers`： 使用するワーカー・プロセスの数で、それぞれがUvicornのワーカーを実行します。
+
+* `--worker-class`： ワーカー・プロセスで使用するGunicorn互換のワーカークラスです。
+    * ここではGunicornがインポートして使用できるクラスを渡します：
+
+        ```Python
+        import uvicorn.workers.UvicornWorker
+        ```
+
+* `--bind`： GunicornにリッスンするIPとポートを伝えます。コロン(`:`)でIPとポートを区切ります。
+    * Uvicornを直接実行している場合は、`--bind 0.0.0.0:80` （Gunicornのオプション）の代わりに、`--host 0.0.0.0`と `--port 80`を使います。
+
+出力では、各プロセスの**PID**（プロセスID）が表示されているのがわかります（単なる数字です）。
+
+以下の通りです：
+
+* Gunicornの**プロセス・マネージャー**はPID `19499`（あなたの場合は違う番号でしょう）で始まります。
+* 次に、`Listening at: http://0.0.0.0:80`を開始します。
+* それから `uvicorn.workers.UvicornWorker` でワーカークラスを使用することを検出します。
+* そして、**4つのワーカー**を起動します。それぞれのワーカーのPIDは、`19511`、`19513`、`19514`、`19515`です。
+
+Gunicornはまた、ワーカーの数を維持するために必要であれば、**ダウンしたプロセス**を管理し、**新しいプロセスを**再起動**させます。そのため、上記のリストにある**再起動**の概念に一部役立ちます。
+
+しかしながら、必要であればGunicornを**再起動**させ、**起動時に実行**させるなど、外部のコンポーネントを持たせることも必要かもしれません。
+
+## Uvicornとワーカー
+
+Uvicornには複数の**ワーカー・プロセス**を起動し実行するオプションもあります。
+
+とはいうものの、今のところUvicornのワーカー・プロセスを扱う機能はGunicornよりも制限されています。そのため、このレベル（Pythonレベル）でプロセスマネージャーを持ちたいのであれば、Gunicornをプロセスマネージャーとして使ってみた方が賢明かもしれないです。
+
+どんな場合であれ、以下のように実行します：
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
+<font color="#A6E22E">INFO</font>:     Uvicorn running on <b>http://0.0.0.0:8080</b> (Press CTRL+C to quit)
+<font color="#A6E22E">INFO</font>:     Started parent process [<font color="#A1EFE4"><b>27365</b></font>]
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27368</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27369</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27370</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27367</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+```
+
+</div>
+
+ここで唯一の新しいオプションは `--workers` で、Uvicornに4つのワーカー・プロセスを起動するように指示しています。
+
+各プロセスの **PID** が表示され、親プロセスの `27365` (これは **プロセスマネージャ**) と、各ワーカー・プロセスの **PID** が表示されます： `27368`、`27369`、`27370`、`27367`になります。
+
+## デプロイメントのコンセプト
+
+ここでは、アプリケーションの実行を**並列化**し、CPUの**マルチコア**を活用し、**より多くのリクエスト**に対応できるようにするために、**Gunicorn**（またはUvicorn）を使用して**Uvicornワーカー・プロセス**を管理する方法を見ていきました。
+
+上記のデプロイのコンセプトのリストから、ワーカーを使うことは主に**レプリケーション**の部分と、**再起動**を少し助けてくれます：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* レプリケーション（実行中のプロセス数）
+* メモリー
+* 開始前の事前のステップ
+
+
+## コンテナとDocker
+<!-- NOTE: the current version of docker.md is outdated compared to English one.  -->
+次章の[コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}では、その他の**デプロイのコンセプト**を扱うために実施するであろう戦略をいくつか紹介します。
+
+また、**GunicornとUvicornワーカー**を含む**公式Dockerイメージ**と、簡単なケースに役立ついくつかのデフォルト設定も紹介します。
+
+また、(Gunicornを使わずに)Uvicornプロセスを1つだけ実行するために、**ゼロから独自のイメージを**構築する方法も紹介します。これは簡単なプロセスで、おそらく**Kubernetes**のような分散コンテナ管理システムを使うときにやりたいことでしょう。
+
+## まとめ
+
+Uvicornワーカーを使ったプロセスマネージャとして**Gunicorn**（またはUvicorn）を使えば、**マルチコアCPU**を活用して**複数のプロセスを並列実行**できます。
+
+これらのツールやアイデアは、**あなた自身のデプロイシステム**をセットアップしながら、他のデプロイコンセプトを自分で行う場合にも使えます。
+
+次の章では、コンテナ（DockerやKubernetesなど）を使った**FastAPI**について学んでいきましょう。これらのツールには、他の**デプロイのコンセプト**も解決する簡単な方法があることがわかるでしょう。✨
diff --git a/docs/ja/docs/external-links.md b/docs/ja/docs/external-links.md
index 6703f5fc2..aca5d5b34 100644
--- a/docs/ja/docs/external-links.md
+++ b/docs/ja/docs/external-links.md
@@ -9,70 +9,21 @@
 !!! tip "豆知識"
     ここにまだ載っていない**FastAPI**に関連する記事、プロジェクト、ツールなどがある場合は、 <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">プルリクエストして下さい</a>。
 
-## 記事
+{% for section_name, section_content in external_links.items() %}
 
-### 英語
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
+
+### {{ 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>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### 日本語
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### ベトナム語
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### ロシア語
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### ドイツ語
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## ポッドキャスト
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## トーク
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
 
 ## プロジェクト
 
diff --git a/docs/ja/docs/features.md b/docs/ja/docs/features.md
index a40b48cf0..853364f11 100644
--- a/docs/ja/docs/features.md
+++ b/docs/ja/docs/features.md
@@ -24,7 +24,7 @@
 
 ### 現代的なPython
 
-FastAPIの機能はすべて、標準のPython 3.6型宣言に基づいています（Pydanticの功績）。新しい構文はありません。ただの現代的な標準のPythonです。
+FastAPIの機能はすべて、標準のPython 3.8型宣言に基づいています（Pydanticの功績）。新しい構文はありません。ただの現代的な標準のPythonです。
 
 （FastAPIを使用しない場合でも）Pythonの型の使用方法について簡単な復習が必要な場合は、短いチュートリアル（[Python Types](python-types.md){.internal-link target=_blank}）を参照してください。
 
diff --git a/docs/ja/docs/help-fastapi.md b/docs/ja/docs/help-fastapi.md
index 166acb586..e753b7ce3 100644
--- a/docs/ja/docs/help-fastapi.md
+++ b/docs/ja/docs/help-fastapi.md
@@ -82,20 +82,6 @@ GitHubレポジトリで<a href="https://github.com/tiangolo/fastapi/issues/new/
 * 既存のissue/バグを修正。
 * 新機能を追加。
 
-## チャットに参加
-
-Gitterでチャットに参加: <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">https://gitter.im/tiangolo/fastapi</a>.
-
-そこで、他の人と手早く会話したり、手助けやアイデアの共有などができます。
-
-しかし、「自由な会話」が許容されているので一般的すぎて回答が難しい質問もしやすくなります。そのせいで回答を得られないかもしれません。
-
-GitHub issuesでは良い回答を得やすい質問ができるように、もしくは、質問する前に自身で解決できるようにテンプレートがガイドしてくれます。そして、GitHubではたとえ時間がかかっても全てに答えているか確認できます。個人的にはGitterチャットでは同じことはできないです。😅
-
-Gitterでの会話はGitHubほど簡単に検索できないので、質問と回答が会話の中に埋もれてしまいます。
-
-一方、チャットには1000人以上いるので、いつでも話し相手が見つかる可能性が高いです。😄
-
 ## 開発者のスポンサーになる
 
 <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a>を通して開発者を経済的にサポートできます。
diff --git a/docs/ja/docs/advanced/conditional-openapi.md b/docs/ja/docs/how-to/conditional-openapi.md
similarity index 100%
rename from docs/ja/docs/advanced/conditional-openapi.md
rename to docs/ja/docs/how-to/conditional-openapi.md
diff --git a/docs/ja/docs/index.md b/docs/ja/docs/index.md
index a9c381a23..f340fdb87 100644
--- a/docs/ja/docs/index.md
+++ b/docs/ja/docs/index.md
@@ -107,7 +107,7 @@ FastAPI は、Pythonの標準である型ヒントに基づいてPython 3.6 以
 
 ## 必要条件
 
-Python 3.7+
+Python 3.8+
 
 FastAPI は巨人の肩の上に立っています。
 
diff --git a/docs/ko/docs/async.md b/docs/ko/docs/async.md
new file mode 100644
index 000000000..47dbaa1b0
--- /dev/null
+++ b/docs/ko/docs/async.md
@@ -0,0 +1,404 @@
+# 동시성과 async / await
+
+*경로 작동 함수*에서의 `async def` 문법에 대한 세부사항과 비동기 코드, 동시성 및 병렬성에 대한 배경
+
+## <a name="in-a-hurry"></a>바쁘신 경우
+
+<strong>요약</strong>
+
+다음과 같이 `await`를 사용해 호출하는 제3의 라이브러리를 사용하는 경우:
+
+```Python
+results = await some_library()
+```
+
+다음처럼 *경로 작동 함수*를 `async def`를 사용해 선언하십시오:
+
+```Python hl_lines="2"
+@app.get('/')
+async def read_results():
+    results = await some_library()
+    return results
+```
+
+!!! note "참고"
+    `async def`로 생성된 함수 내부에서만 `await`를 사용할 수 있습니다.
+
+---
+
+데이터베이스, API, 파일시스템 등과 의사소통하는 제3의 라이브러리를 사용하고, 그것이 `await`를 지원하지 않는 경우(현재 거의 모든 데이터베이스 라이브러리가 그러합니다), *경로 작동 함수*를 일반적인 `def`를 사용해 선언하십시오:
+
+```Python hl_lines="2"
+@app.get('/')
+def results():
+    results = some_library()
+    return results
+```
+
+---
+
+만약 당신의 응용프로그램이 (어째서인지) 다른 무엇과 의사소통하고 그것이 응답하기를 기다릴 필요가 없다면 `async def`를 사용하십시오.
+
+---
+
+모르겠다면, 그냥 `def`를 사용하십시오.
+
+---
+
+**참고**: *경로 작동 함수*에서 필요한만큼 `def`와 `async def`를 혼용할 수 있고, 가장 알맞은 것을 선택해서 정의할 수 있습니다. FastAPI가 자체적으로 알맞은 작업을 수행할 것입니다.
+
+어찌되었든, 상기 어떠한 경우라도, FastAPI는 여전히 비동기적으로 작동하고 매우 빠릅니다.
+
+그러나 상기 작업을 수행함으로써 어느 정도의 성능 최적화가 가능합니다.
+
+## 기술적 세부사항
+
+최신 파이썬 버전은 `async`와 `await` 문법과 함께 **“코루틴”**이라고 하는 것을 사용하는 **“비동기 코드”**를 지원합니다.
+
+아래 섹션들에서 해당 문장을 부분별로 살펴보겠습니다:
+
+* **비동기 코드**
+* **`async`와 `await`**
+* **코루틴**
+
+## 비동기 코드
+
+비동기 코드란 언어 💬 가 코드의 어느 한 부분에서, 컴퓨터 / 프로그램🤖에게 *다른 무언가*가 어딘가에서 끝날 때까지 기다려야한다고 말하는 방식입니다. *다른 무언가*가 “느린-파일" 📝 이라고 불린다고 가정해봅시다.
+
+따라서 “느린-파일” 📝이 끝날때까지 컴퓨터는 다른 작업을 수행할 수 있습니다.
+
+그 다음 컴퓨터 / 프로그램 🤖 은 다시 기다리고 있기 때문에 기회가 있을 때마다 다시 돌아오거나, 혹은 당시에 수행해야하는 작업들이 완료될 때마다 다시 돌아옵니다. 그리고 그것 🤖 은 기다리고 있던 작업 중 어느 것이 이미 완료되었는지, 그것 🤖 이 해야하는 모든 작업을 수행하면서 확인합니다.
+
+다음으로, 그것 🤖 은 완료할 첫번째 작업에 착수하고(우리의 "느린-파일" 📝 이라고 가정합시다) 그에 대해 수행해야하는 작업을 계속합니다.
+
+"다른 무언가를 기다리는 것"은 일반적으로 비교적 "느린" (프로세서와 RAM 메모리 속도에 비해) <abbr title="Input and Output">I/O</abbr> 작업을 의미합니다. 예를 들면 다음의 것들을 기다리는 것입니다:
+
+* 네트워크를 통해 클라이언트로부터 전송되는 데이터
+* 네트워크를 통해 클라이언트가 수신할, 당신의 프로그램으로부터 전송되는 데이터
+* 시스템이 읽고 프로그램에 전달할 디스크 내의 파일 내용
+* 당신의 프로그램이 시스템에 전달하는, 디스크에 작성될 내용
+* 원격 API 작업
+* 완료될 데이터베이스 작업
+* 결과를 반환하는 데이터베이스 쿼리
+* 기타
+
+수행 시간의 대부분이 <abbr title="Input and Output">I/O</abbr> 작업을 기다리는데에 소요되기 때문에, "I/O에 묶인" 작업이라고 불립니다.
+
+이것은 "비동기"라고 불리는데 컴퓨터 / 프로그램이 작업 결과를 가지고 일을 수행할 수 있도록, 느린 작업에 "동기화"되어 아무것도 하지 않으면서 작업이 완료될 정확한 시점만을 기다릴 필요가 없기 때문입니다.
+
+이 대신에, "비동기" 시스템에서는, 작업은 일단 완료되면, 컴퓨터 / 프로그램이 수행하고 있는 일을 완료하고 이후 다시 돌아와서 그것의 결과를 받아 이를 사용해 작업을 지속할 때까지 잠시 (몇 마이크로초) 대기할 수 있습니다.
+
+"동기"("비동기"의 반대)는 컴퓨터 / 프로그램이 상이한 작업들간 전환을 하기 전에 그것이 대기를 동반하게 될지라도 모든 순서를 따르기 때문에 "순차"라는 용어로도 흔히 불립니다.
+
+### 동시성과 버거
+
+위에서 설명한 **비동기** 코드에 대한 개념은 종종 **"동시성"**이라고도 불립니다. 이것은 **"병렬성"**과는 다릅니다.
+
+**동시성**과 **병렬성**은 모두 "동시에 일어나는 서로 다른 일들"과 관련이 있습니다.
+
+하지만 *동시성*과 *병렬성*의 세부적인 개념에는 꽤 차이가 있습니다.
+
+차이를 확인하기 위해, 다음의 버거에 대한 이야기를 상상해보십시오:
+
+### 동시 버거
+
+당신은 짝사랑 상대 😍 와 패스트푸드 🍔 를 먹으러 갔습니다. 당신은 점원 💁 이 당신 앞에 있는 사람들의 주문을 받을 동안 줄을 서서 기다리고 있습니다.
+
+이제 당신의 순서가 되어서, 당신은 당신과 짝사랑 상대 😍 를 위한 두 개의 고급스러운 버거 🍔 를 주문합니다.
+
+당신이 돈을 냅니다 💸.
+
+점원 💁 은 주방 👨‍🍳 에 요리를 하라고 전달하고, 따라서 그들은 당신의 버거 🍔 를 준비해야한다는 사실을 알게됩니다(그들이 지금은 당신 앞 고객들의 주문을 준비하고 있을지라도 말입니다).
+
+점원 💁 은 당신의 순서가 적힌 번호표를 줍니다.
+
+기다리는 동안, 당신은 짝사랑 상대 😍 와 함께 테이블을 고르고, 자리에 앉아 오랫동안 (당신이 주문한 버거는 꽤나 고급스럽기 때문에 준비하는데 시간이 조금 걸립니다 ✨🍔✨) 대화를 나눕니다.
+
+짝사랑 상대 😍 와 테이블에 앉아서 버거 🍔 를 기다리는 동안, 그 사람 😍 이 얼마나 멋지고, 사랑스럽고, 똑똑한지 감탄하며 시간을 보냅니다 ✨😍✨.
+
+짝사랑 상대 😍 와 기다리면서 얘기하는 동안, 때때로, 당신은 당신의 차례가 되었는지 보기 위해 카운터의 번호를 확인합니다.
+
+그러다 어느 순간, 당신의 차례가 됩니다. 카운터에 가서, 버거 🍔 를 받고, 테이블로 다시 돌아옵니다.
+
+당신과 짝사랑 상대 😍 는 버거 🍔 를 먹으며 좋은 시간을 보냅니다 ✨.
+
+---
+
+당신이 이 이야기에서 컴퓨터 / 프로그램 🤖 이라고 상상해보십시오.
+
+줄을 서서 기다리는 동안, 당신은 아무것도 하지 않고 😴 당신의 차례를 기다리며, 어떠한 "생산적인" 일도 하지 않습니다. 하지만 점원 💁 이 (음식을 준비하지는 않고) 주문을 받기만 하기 때문에 줄이 빨리 줄어들어서 괜찮습니다.
+
+그다음, 당신이 차례가 오면, 당신은 실제로 "생산적인" 일 🤓 을 합니다. 당신은 메뉴를 보고, 무엇을 먹을지 결정하고, 짝사랑 상대 😍 의 선택을 묻고, 돈을 내고 💸 , 맞는 카드를 냈는지 확인하고, 비용이 제대로 지불되었는지 확인하고, 주문이 제대로 들어갔는지 확인을 하는 작업 등등을 수행합니다.
+
+하지만 이후에는, 버거 🍔 를 아직 받지 못했음에도, 버거가 준비될 때까지 기다려야 🕙 하기 때문에 점원 💁 과의 작업은 "일시정지" ⏸  상태입니다.
+
+하지만 번호표를 받고 카운터에서 나와 테이블에 앉으면, 당신은 짝사랑 상대 😍 와 그 "작업"  ⏯ 🤓 에 번갈아가며 🔀  집중합니다. 그러면 당신은 다시 짝사랑 상대 😍 에게 작업을 거는 매우 "생산적인" 일 🤓 을 합니다.
+
+점원 💁 이 카운터 화면에 당신의 번호를 표시함으로써 "버거 🍔 가 준비되었습니다"라고 해도, 당신은 즉시 뛰쳐나가지는 않을 것입니다. 당신은 당신의 번호를 갖고있고, 다른 사람들은 그들의 번호를 갖고있기 때문에, 아무도 당신의 버거 🍔 를 훔쳐가지 않는다는 사실을 알기 때문입니다.
+
+그래서 당신은 짝사랑 상대 😍 가 이야기를 끝낼 때까지 기다린 후 (현재 작업 완료 ⏯ / 진행 중인 작업 처리 🤓 ), 정중하게 미소짓고 버거를 가지러 가겠다고 말합니다 ⏸.
+
+그다음 당신은 카운터에 가서 🔀 , 초기 작업을 이제 완료하고 ⏯ , 버거 🍔 를 받고, 감사하다고 말하고 테이블로 가져옵니다. 이로써 카운터와의 상호작용 단계 / 작업이 종료됩니다 ⏹.
+
+이전 작업인 "버거 받기"가 종료되면 ⏹ "버거 먹기"라는 새로운 작업이 생성됩니다 🔀 ⏯.
+
+### 병렬 버거
+
+이제 "동시 버거"가 아닌 "병렬 버거"를 상상해보십시오.
+
+당신은 짝사랑 상대 😍 와 함께 병렬 패스트푸드 🍔 를 먹으러 갔습니다.
+
+당신은 여러명(8명이라고 가정합니다)의 점원이 당신 앞 사람들의 주문을 받으며 동시에 요리 👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳 도 하는 동안 줄을 서서 기다립니다.
+
+당신 앞 모든 사람들이 버거가 준비될 때까지 카운터에서 떠나지 않고 기다립니다 🕙 . 왜냐하면 8명의 직원들이 다음 주문을 받기 전에 버거를 준비하러 가기 때문입니다.
+
+마침내 당신의 차례가 왔고, 당신은 당신과 짝사랑 상대 😍 를 위한 두 개의 고급스러운 버거 🍔 를 주문합니다.
+
+당신이 비용을 지불합니다 💸 .
+
+점원이 주방에 갑니다 👨‍🍳 .
+
+당신은 번호표가 없기 때문에 누구도 당신의 버거 🍔 를 대신 가져갈 수 없도록 카운터에 서서 기다립니다 🕙 .
+
+당신과 짝사랑 상대 😍 는 다른 사람이 새치기해서 버거를 가져가지 못하게 하느라 바쁘기 때문에 🕙 , 짝사랑 상대에게 주의를 기울일 수 없습니다 😞 .
+
+이것은 "동기" 작업이고, 당신은 점원/요리사 👨‍🍳 와 "동기화" 되었습니다. 당신은 기다리고 🕙 , 점원/요리사 👨‍🍳 가 버거 🍔  준비를 완료한 후 당신에게 주거나, 누군가가 그것을 가져가는 그 순간에 그 곳에 있어야합니다.
+
+카운터 앞에서 오랫동안 기다린 후에 🕙 , 점원/요리사 👨‍🍳 가 당신의 버거 🍔 를 가지고 돌아옵니다.
+
+당신은 버거를 받고 짝사랑 상대와 함께 테이블로 돌아옵니다.
+
+단지 먹기만 하다가, 다 먹었습니다 🍔 ⏹.
+
+카운터 앞에서 기다리면서 🕙  너무 많은 시간을 허비했기 때문에 대화를 하거나 작업을 걸 시간이 거의 없었습니다 😞 .
+
+---
+
+이 병렬 버거 시나리오에서, 당신은 기다리고 🕙 , 오랜 시간동안 "카운터에서 기다리는" 🕙 데에 주의를 기울이는 ⏯ 두 개의 프로세서(당신과 짝사랑 상대😍)를 가진 컴퓨터 / 프로그램 🤖 입니다.
+
+패스트푸드점에는 8개의 프로세서(점원/요리사) 👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳 가 있습니다. 동시 버거는 단 두 개(한 명의 직원과 한 명의 요리사) 💁 👨‍🍳 만을 가지고 있었습니다.
+
+하지만 여전히, 병렬 버거 예시가 최선은 아닙니다 😞 .
+
+---
+
+이 예시는 버거🍔 이야기와 결이 같습니다.
+
+더 "현실적인" 예시로, 은행을 상상해보십시오.
+
+최근까지, 대다수의 은행에는 다수의 은행원들 👨‍💼👨‍💼👨‍💼👨‍💼 과 긴 줄 🕙🕙🕙🕙🕙🕙🕙🕙 이 있습니다.
+
+모든 은행원들은 한 명 한 명의 고객들을 차례로 상대합니다 👨‍💼⏯ .
+
+그리고 당신은 오랫동안 줄에서 기다려야하고 🕙 , 그렇지 않으면 당신의 차례를 잃게 됩니다.
+
+아마 당신은 은행 🏦 심부름에 짝사랑 상대 😍 를 데려가고 싶지는 않을 것입니다.
+
+### 버거 예시의 결론
+
+"짝사랑 상대와의 패스트푸드점 버거" 시나리오에서, 오랜 기다림 🕙 이 있기 때문에 동시 시스템 ⏸🔀⏯ 을 사용하는 것이 더 합리적입니다.
+
+대다수의 웹 응용프로그램의 경우가 그러합니다.
+
+매우 많은 수의 유저가 있지만, 서버는 그들의 요청을 전송하기 위해 그닥-좋지-않은 연결을 기다려야 합니다 🕙 .
+
+그리고 응답이 돌아올 때까지 다시 기다려야 합니다 🕙 .
+
+이 "기다림" 🕙 은 마이크로초 단위이지만, 모두 더해지면, 결국에는 매우 긴 대기시간이 됩니다.
+
+따라서 웹 API를 위해 비동기 ⏸🔀⏯ 코드를 사용하는 것이 합리적입니다.
+
+대부분의 존재하는 유명한 파이썬 프레임워크 (Flask와 Django 등)은 새로운 비동기 기능들이 파이썬에 존재하기 전에 만들어졌습니다. 그래서, 그들의 배포 방식은 병렬 실행과 새로운 기능만큼 강력하지는 않은 예전 버전의 비동기 실행을 지원합니다.
+
+비동기 웹 파이썬(ASGI)에 대한 주요 명세가 웹소켓을 지원하기 위해 Django에서 개발 되었음에도 그렇습니다.
+
+이러한 종류의 비동기성은 (NodeJS는 병렬적이지 않음에도) NodeJS가 사랑받는 이유이고, 프로그래밍 언어로서의 Go의 강점입니다.
+
+그리고 **FastAPI**를 사용함으로써 동일한 성능을 낼 수 있습니다.
+
+또한 병렬성과 비동기성을 동시에 사용할 수 있기 때문에, 대부분의 테스트가 완료된 NodeJS 프레임워크보다 더 높은 성능을 얻고 C에 더 가까운 컴파일 언어인 Go와 동등한 성능을 얻을 수 있습니다<a href="https://www.techempower.com/benchmarks/#section=data-r17&hw=ph&test=query&l=zijmkf-1" class="external-link" target="_blank">(모두 Starlette 덕분입니다)</a>.
+
+### 동시성이 병렬성보다 더 나은가?
+
+그렇지 않습니다! 그것이 이야기의 교훈은 아닙니다.
+
+동시성은 병렬성과 다릅니다. 그리고 그것은 많은 대기를 필요로하는 **특정한** 시나리오에서는 더 낫습니다. 이로 인해, 웹 응용프로그램 개발에서 동시성이 병렬성보다 일반적으로 훨씬 낫습니다. 하지만 모든 경우에 그런 것은 아닙니다.
+
+따라서, 균형을 맞추기 위해, 다음의 짧은 이야기를 상상해보십시오:
+
+> 당신은 크고, 더러운 집을 청소해야합니다.
+
+*네, 이게 전부입니다*.
+
+---
+
+어디에도 대기 🕙 는 없고, 집안 곳곳에서 해야하는 많은 작업들만 있습니다.
+
+버거 예시처럼 처음에는 거실, 그 다음은 부엌과 같은 식으로 순서를 정할 수도 있으나, 무엇도 기다리지 🕙 않고 계속해서 청소 작업만 수행하기 때문에, 순서는 아무런 영향을 미치지 않습니다.
+
+순서가 있든 없든 동일한 시간이 소요될 것이고(동시성) 동일한 양의 작업을 하게 될 것입니다.
+
+하지만 이 경우에서, 8명의 전(前)-점원/요리사이면서-현(現)-청소부 👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳 를 고용할 수 있고, 그들 각자(그리고 당신)가 집의 한 부분씩 맡아 청소를 한다면, 당신은 **병렬적**으로 작업을 수행할 수 있고, 조금의 도움이 있다면, 훨씬 더 빨리 끝낼 수 있습니다.
+
+이 시나리오에서, (당신을 포함한) 각각의 청소부들은 프로세서가 될 것이고, 각자의 역할을 수행합니다.
+
+실행 시간의 대부분이 대기가 아닌 실제 작업에 소요되고, 컴퓨터에서 작업은 <abbr title="Central Processing Unit">CPU</abbr>에서 이루어지므로, 이러한 문제를 "CPU에 묶였"다고 합니다.
+
+---
+
+CPU에 묶인 연산에 관한 흔한 예시는 복잡한 수학 처리를 필요로 하는 경우입니다.
+
+예를 들어:
+
+* **오디오** 또는 **이미지** 처리.
+* **컴퓨터 비전**: 하나의 이미지는 수백개의 픽셀로 구성되어있고, 각 픽셀은 3개의 값 / 색을 갖고 있으며, 일반적으로 해당 픽셀들에 대해 동시에 무언가를 계산해야하는 처리.
+* **머신러닝**: 일반적으로 많은 "행렬"과 "벡터" 곱셈이 필요합니다. 거대한 스프레드 시트에 수들이 있고 그 수들을 동시에 곱해야 한다고 생각해보십시오.
+* **딥러닝**: 머신러닝의 하위영역으로, 동일한 예시가 적용됩니다. 단지 이 경우에는 하나의 스프레드 시트에 곱해야할 수들이 있는 것이 아니라, 거대한 세트의 스프레드 시트들이 있고, 많은 경우에, 이 모델들을 만들고 사용하기 위해 특수한 프로세서를 사용합니다.
+
+### 동시성 + 병렬성: 웹 + 머신러닝
+
+**FastAPI**를 사용하면 웹 개발에서는 매우 흔한 동시성의 이점을 (NodeJS의 주된 매력만큼) 얻을 수 있습니다.
+
+뿐만 아니라 머신러닝 시스템과 같이 **CPU에 묶인** 작업을 위해 병렬성과 멀티프로세싱(다수의 프로세스를 병렬적으로 동작시키는 것)을 이용하는 것도 가능합니다.
+
+파이썬이 **데이터 사이언스**, 머신러닝과 특히 딥러닝에 의 주된 언어라는 간단한 사실에 더해서, 이것은 FastAPI를 데이터 사이언스 / 머신러닝 웹 API와 응용프로그램에 (다른 것들보다) 좋은 선택지가 되게 합니다.
+
+배포시 병렬을 어떻게 가능하게 하는지 알고싶다면, [배포](/ko/deployment){.internal-link target=_blank}문서를 참고하십시오.
+
+## `async`와  `await`
+
+최신 파이썬 버전에는 비동기 코드를 정의하는 매우 직관적인 방법이 있습니다. 이는 이것을 평범한 "순차적" 코드로 보이게 하고, 적절한 순간에 당신을 위해 "대기"합니다.
+
+연산이 결과를 전달하기 전에 대기를 해야하고 새로운 파이썬 기능들을 지원한다면, 이렇게 코드를 작성할 수 있습니다:
+
+```Python
+burgers = await get_burgers(2)
+```
+
+여기서 핵심은 `await`입니다. 이것은 파이썬에게 `burgers` 결과를 저장하기 이전에 `get_burgers(2)`의 작업이 완료되기를 🕙 기다리라고 ⏸ 말합니다. 이로 인해, 파이썬은 그동안 (다른 요청을 받는 것과 같은) 다른 작업을 수행해도 된다는 것을 🔀 ⏯ 알게될 것입니다.
+
+`await`가 동작하기 위해, 이것은 비동기를 지원하는 함수 내부에 있어야 합니다. 이를 위해서 함수를 `async def`를 사용해 정의하기만 하면 됩니다:
+
+```Python hl_lines="1"
+async def get_burgers(number: int):
+    # Do some asynchronous stuff to create the burgers
+    return burgers
+```
+
+...`def`를 사용하는 대신:
+
+```Python hl_lines="2"
+# This is not asynchronous
+def get_sequential_burgers(number: int):
+    # Do some sequential stuff to create the burgers
+    return burgers
+```
+
+`async def`를 사용하면, 파이썬은 해당 함수 내에서 `await` 표현에 주의해야한다는 사실과, 해당 함수의 실행을 "일시정지"⏸하고 다시 돌아오기 전까지 다른 작업을 수행🔀할 수 있다는 것을 알게됩니다.
+
+`async def`f 함수를 호출하고자 할 때, "대기"해야합니다. 따라서, 아래는 동작하지 않습니다.
+
+```Python
+# This won't work, because get_burgers was defined with: async def
+burgers = get_burgers(2)
+```
+
+---
+
+따라서, `await`f를 사용해서 호출할 수 있는 라이브러리를 사용한다면, 다음과 같이 `async def`를 사용하는 *경로 작동 함수*를 생성해야 합니다:
+
+```Python hl_lines="2-3"
+@app.get('/burgers')
+async def read_burgers():
+    burgers = await get_burgers(2)
+    return burgers
+```
+
+### 더 세부적인 기술적 사항
+
+`await`가 `async def`를 사용하는 함수 내부에서만 사용이 가능하다는 것을 눈치채셨을 것입니다.
+
+하지만 동시에, `async def`로 정의된 함수들은 "대기"되어야만 합니다. 따라서, `async def`를 사용한 함수들은 역시 `async def`를 사용한 함수 내부에서만 호출될 수 있습니다.
+
+그렇다면 닭이 먼저냐, 달걀이 먼저냐, 첫 `async` 함수를 어떻게 호출할 수 있겠습니까?
+
+**FastAPI**를 사용해 작업한다면 이것을 걱정하지 않아도 됩니다. 왜냐하면 그 "첫" 함수는 당신의 *경로 작동 함수*가 될 것이고, FastAPI는 어떻게 올바르게 처리할지 알고있기 때문입니다.
+
+하지만 FastAPI를 사용하지 않고 `async` / `await`를 사용하고 싶다면, 이 역시 가능합니다.
+
+### 당신만의 비동기 코드 작성하기
+
+Starlette(그리고 FastAPI)는 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>를 기반으로 하고있고, 따라서 파이썬 표준 라이브러리인 <a href="https://docs.python.org/3/library/asyncio-task.html" class="external-link" target="_blank">asyncio</a> 및 <a href="https://trio.readthedocs.io/en/stable/" class="external-link" target="_blank">Trio</a>와 호환됩니다.
+
+특히, 코드에서 고급 패턴이 필요한 고급 동시성을 사용하는 경우 직접적으로 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>를 사용할 수 있습니다.
+
+FastAPI를 사용하지 않더라도, 높은 호환성 및 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>의 이점(예: *구조화된 동시성*)을 취하기 위해 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>를 사용해 비동기 응용프로그램을 작성할 수 있습니다.
+
+### 비동기 코드의 다른 형태
+
+파이썬에서 `async`와 `await`를 사용하게 된 것은 비교적 최근의 일입니다.
+
+하지만 이로 인해 비동기 코드 작업이 훨씬 간단해졌습니다.
+
+같은 (또는 거의 유사한) 문법은 최신 버전의 자바스크립트(브라우저와 NodeJS)에도 추가되었습니다.
+
+하지만 그 이전에, 비동기 코드를 처리하는 것은 꽤 복잡하고 어려운 일이었습니다.
+
+파이썬의 예전 버전이라면, 스레드 또는 <a href="https://www.gevent.org/" class="external-link" target="_blank">Gevent</a>를 사용할 수 있을 것입니다. 하지만 코드를 이해하고, 디버깅하고, 이에 대해 생각하는게 훨씬 복잡합니다.
+
+예전 버전의 NodeJS / 브라우저 자바스크립트라면, "콜백 함수"를 사용했을 것입니다. 그리고 이로 인해 <a href="http://callbackhell.com/" class="external-link" target="_blank">콜백 지옥</a>에 빠지게 될 수 있습니다.
+
+## 코루틴
+
+**코루틴**은 `async def` 함수가 반환하는 것을 칭하는 매우 고급스러운 용어일 뿐입니다. 파이썬은 그것이 시작되고 어느 시점에서 완료되지만 내부에 `await`가 있을 때마다 내부적으로 일시정지⏸될 수도 있는 함수와 유사한 것이라는 사실을 알고있습니다.
+
+그러나 `async` 및 `await`와 함께 비동기 코드를 사용하는 이 모든 기능들은 "코루틴"으로 간단히 요약됩니다. 이것은 Go의 주된 핵심 기능인 "고루틴"에 견줄 수 있습니다.
+
+## 결론
+
+상기 문장을 다시 한 번 봅시다:
+
+> 최신 파이썬 버전은 **`async` 및 `await`** 문법과 함께 **“코루틴”**이라고 하는 것을 사용하는 **“비동기 코드”**를 지원합니다.
+
+이제 이 말을 조금 더 이해할 수 있을 것입니다. ✨
+
+이것이 (Starlette을 통해) FastAPI를 강하게 하면서 그것이 인상적인 성능을 낼 수 있게 합니다.
+
+## 매우 세부적인 기술적 사항
+
+!!! warning "경고"
+    이 부분은 넘어가도 됩니다.
+
+    이것들은 **FastAPI**가 내부적으로 어떻게 동작하는지에 대한 매우 세부적인 기술사항입니다.
+
+    만약 기술적 지식(코루틴, 스레드, 블록킹 등)이 있고 FastAPI가 어떻게 `async def` vs `def`를 다루는지 궁금하다면, 계속하십시오.
+
+### 경로 작동 함수
+
+경로 작동 함수를 `async def` 대신 일반적인 `def`로 선언하는 경우, (서버를 차단하는 것처럼) 그것을 직접 호출하는 대신 대기중인 외부 스레드풀에서 실행됩니다.
+
+만약 상기에 묘사된대로 동작하지 않는 비동기 프로그램을 사용해왔고 약간의 성능 향상 (약 100 나노초)을 위해 `def`를 사용해서 계산만을 위한 사소한 *경로 작동 함수*를 정의해왔다면, **FastAPI**는 이와는 반대라는 것에 주의하십시오. 이러한 경우에, *경로 작동 함수*가 블로킹 <abbr title="Input/Output: 디스크 읽기 또는 쓰기, 네트워크 통신.">I/O</abbr>를 수행하는 코드를 사용하지 않는 한 `async def`를 사용하는 편이 더 낫습니다.
+
+하지만 두 경우 모두, FastAPI가 당신이 전에 사용하던 프레임워크보다 [더 빠를](/#performance){.internal-link target=_blank} (최소한 비견될) 확률이 높습니다.
+
+### 의존성
+
+의존성에도 동일하게 적용됩니다. 의존성이 `async def`가 아닌 표준 `def` 함수라면, 외부 스레드풀에서 실행됩니다.
+
+### 하위-의존성
+
+함수 정의시 매개변수로 서로를 필요로하는 다수의 의존성과 하위-의존성을 가질 수 있고, 그 중 일부는 `async def`로, 다른 일부는 일반적인 `def`로 생성되었을 수 있습니다. 이것은 여전히 잘 동작하고, 일반적인 `def`로 생성된 것들은 "대기"되는 대신에 (스레드풀로부터) 외부 스레드에서 호출됩니다.
+
+### 다른 유틸리티 함수
+
+직접 호출되는 다른 모든 유틸리티 함수는 일반적인 `def`나 `async def`로 생성될 수 있고 FastAPI는 이를 호출하는 방식에 영향을 미치지 않습니다.
+
+이것은 FastAPI가 당신을 위해 호출하는 함수와는 반대입니다: *경로 작동 함수*와 의존성
+
+만약 당신의 유틸리티 함수가 `def`를 사용한 일반적인 함수라면, 스레드풀에서가 아니라 직접 호출(당신이 코드에 작성한 대로)될 것이고, `async def`로 생성된 함수라면 코드에서 호출할 때 그 함수를 `await` 해야 합니다.
+
+---
+
+다시 말하지만, 이것은 당신이 이것에 대해 찾고있던 경우에 한해 유용할 매우 세부적인 기술사항입니다.
+
+그렇지 않은 경우, 상기의 가이드라인만으로도 충분할 것입니다: [바쁘신 경우](#in-a-hurry).
diff --git a/docs/ko/docs/deployment/cloud.md b/docs/ko/docs/deployment/cloud.md
new file mode 100644
index 000000000..f2b965a91
--- /dev/null
+++ b/docs/ko/docs/deployment/cloud.md
@@ -0,0 +1,17 @@
+# FastAPI를 클라우드 제공업체에서 배포하기
+
+사실상 거의 **모든 클라우드 제공업체**를 사용하여 여러분의 FastAPI 애플리케이션을 배포할 수 있습니다.
+
+대부분의 경우, 주요 클라우드 제공업체에서는 FastAPI를 배포할 수 있도록 가이드를 제공합니다.
+
+## 클라우드 제공업체 - 후원자들
+
+몇몇 클라우드 제공업체들은 [**FastAPI를 후원하며**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, 이를 통해 FastAPI와 FastAPI **생태계**가 지속적이고 건전한 **발전**을 할 수 있습니다.
+
+이는 FastAPI와 **커뮤니티** (여러분)에 대한 진정한 헌신을 보여줍니다. 그들은 여러분에게 **좋은 서비스**를 제공할 뿐 만이 아니라 여러분이 **훌륭하고 건강한 프레임워크인** FastAPI 를 사용하길 원하기 때문입니다. 🙇
+
+아래와 같은 서비스를 사용해보고 각 서비스의 가이드를 따를 수도 있습니다:
+
+* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
+* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
+* <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a>
diff --git a/docs/ko/docs/index.md b/docs/ko/docs/index.md
index a6991a9b8..7ce938106 100644
--- a/docs/ko/docs/index.md
+++ b/docs/ko/docs/index.md
@@ -107,7 +107,7 @@ FastAPI는 현대적이고, 빠르며(고성능), 파이썬 표준 타입 힌트
 
 ## 요구사항
 
-Python 3.7+
+Python 3.8+
 
 FastAPI는 거인들의 어깨 위에 서 있습니다:
 
diff --git a/docs/pl/docs/features.md b/docs/pl/docs/features.md
index 49d362dd9..ed10af9bc 100644
--- a/docs/pl/docs/features.md
+++ b/docs/pl/docs/features.md
@@ -25,7 +25,7 @@ Interaktywna dokumentacja i webowe interfejsy do eksploracji API. Z racji tego,
 
 ### Nowoczesny Python
 
-Wszystko opiera się na standardowych deklaracjach typu **Python 3.6** (dzięki Pydantic). Brak nowej składni do uczenia. Po prostu standardowy, współczesny Python.
+Wszystko opiera się na standardowych deklaracjach typu **Python 3.8** (dzięki Pydantic). Brak nowej składni do uczenia. Po prostu standardowy, współczesny Python.
 
 Jeśli potrzebujesz szybkiego przypomnienia jak używać deklaracji typów w Pythonie (nawet jeśli nie używasz FastAPI), sprawdź krótki samouczek: [Python Types](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/pl/docs/help-fastapi.md b/docs/pl/docs/help-fastapi.md
new file mode 100644
index 000000000..3d02a8741
--- /dev/null
+++ b/docs/pl/docs/help-fastapi.md
@@ -0,0 +1,263 @@
+# Pomóż FastAPI - Uzyskaj pomoc
+
+Czy podoba Ci się **FastAPI**?
+
+Czy chciałbyś pomóc FastAPI, jego użytkownikom i autorowi?
+
+Może napotkałeś na trudności z **FastAPI** i potrzebujesz pomocy?
+
+Istnieje kilka bardzo łatwych sposobów, aby pomóc (czasami wystarczy jedno lub dwa kliknięcia).
+
+Istnieje również kilka sposobów uzyskania pomocy.
+
+## Zapisz się do newslettera
+
+Możesz zapisać się do rzadkiego [newslettera o **FastAPI i jego przyjaciołach**](/newsletter/){.internal-link target=_blank}, aby być na bieżąco z:
+
+* Aktualnościami o FastAPI i przyjaciołach 🚀
+* Przewodnikami 📝
+* Funkcjami ✨
+* Przełomowymi zmianami 🚨
+* Poradami i sztuczkami ✅
+
+## Śledź FastAPI na Twitterze
+
+<a href="https://twitter.com/fastapi" class="external-link" target="_blank">Śledź @fastapi na **Twitterze**</a> aby być na bieżąco z najnowszymi wiadomościami o **FastAPI**. 🐦
+
+## Dodaj gwiazdkę **FastAPI** na GitHubie
+
+Możesz "dodać gwiazdkę" FastAPI na GitHubie (klikając przycisk gwiazdki w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. ⭐️
+
+Dodając gwiazdkę, inni użytkownicy będą mogli łatwiej znaleźć projekt i zobaczyć, że był już przydatny dla innych.
+
+## Obserwuj repozytorium GitHub w poszukiwaniu nowych wydań
+
+Możesz "obserwować" FastAPI na GitHubie (klikając przycisk "obserwuj" w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Wybierz opcję "Tylko wydania".
+
+Dzięki temu będziesz otrzymywać powiadomienia (na swój adres e-mail) za każdym razem, gdy pojawi się nowe wydanie (nowa wersja) **FastAPI** z poprawkami błędów i nowymi funkcjami.
+
+## Skontaktuj się z autorem
+
+Możesz skontaktować się <a href="https://tiangolo.com" class="external-link" target="_blank">ze mną (Sebastián Ramírez / `tiangolo`)</a>, autorem.
+
+Możesz:
+
+* <a href="https://github.com/tiangolo" class="external-link" target="_blank">Śledzić mnie na **GitHubie**</a>.
+    * Zobacz inne projekty open source, które stworzyłem, a mogą być dla Ciebie pomocne.
+    * Śledź mnie, aby dostać powiadomienie, gdy utworzę nowy projekt open source.
+* <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">Śledzić mnie na **Twitterze**</a> lub na <a href="https://fosstodon.org/@tiangolo" class="external-link" target="_blank">Mastodonie</a>.
+    * Napisz mi, w jaki sposób korzystasz z FastAPI (uwielbiam o tym czytać).
+    * Dowiedz się, gdy ogłoszę coś nowego lub wypuszczę nowe narzędzia.
+    * Możesz także <a href="https://twitter.com/fastapi" class="external-link" target="_blank">śledzić @fastapi na Twitterze</a> (to oddzielne konto).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Nawiąż ze mną kontakt na **Linkedinie**</a>.
+    * Dowiedz się, gdy ogłoszę coś nowego lub wypuszczę nowe narzędzia (chociaż częściej korzystam z Twittera 🤷‍♂).
+* Czytaj moje posty (lub śledź mnie) na <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> lub na <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
+    * Czytaj o innych pomysłach, artykułach i dowiedz się o narzędziach, które stworzyłem.
+    * Śledź mnie, by wiedzieć gdy opublikuję coś nowego.
+
+## Napisz tweeta o **FastAPI**
+
+<a href="https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/tiangolo/fastapi" class="external-link" target="_blank">Napisz tweeta o **FastAPI**</a> i powiedz czemu Ci się podoba. 🎉
+
+Uwielbiam czytać w jaki sposób **FastAPI** jest używane, co Ci się w nim podobało, w jakim projekcie/firmie go używasz itp.
+
+## Głosuj na FastAPI
+
+* <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">Głosuj na **FastAPI** w Slant</a>.
+* <a href="https://alternativeto.net/software/fastapi/" class="external-link" target="_blank">Głosuj na **FastAPI** w AlternativeTo</a>.
+* <a href="https://stackshare.io/pypi-fastapi" class="external-link" target="_blank">Powiedz, że używasz **FastAPI** na StackShare</a>.
+
+## Pomagaj innym, odpowiadając na ich pytania na GitHubie
+
+Możesz spróbować pomóc innym, odpowiadając w:
+
+* <a href="https://github.com/tiangolo/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered" class="external-link" target="_blank">Dyskusjach na GitHubie</a>
+* <a href="https://github.com/tiangolo/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+" class="external-link" target="_blank">Problemach na GitHubie</a>
+
+W wielu przypadkach możesz już znać odpowiedź na te pytania. 🤓
+
+Jeśli pomożesz wielu ludziom, możesz zostać oficjalnym [Ekspertem FastAPI](fastapi-people.md#experts){.internal-link target=_blank}. 🎉
+
+Pamiętaj tylko o najważniejszym: bądź życzliwy. Ludzie przychodzą sfrustrowani i w wielu przypadkach nie zadają pytań w najlepszy sposób, ale mimo to postaraj się być dla nich jak najbardziej życzliwy. 🤗
+
+Chciałbym, by społeczność **FastAPI** była życzliwa i przyjazna. Nie akceptuj prześladowania ani braku szacunku wobec innych. Dbajmy o siebie nawzajem.
+
+---
+
+Oto, jak pomóc innym z pytaniami (w dyskusjach lub problemach):
+
+### Zrozum pytanie
+
+* Upewnij się, czy rozumiesz **cel** i przypadek użycia osoby pytającej.
+
+* Następnie sprawdź, czy pytanie (większość to pytania) jest **jasne**.
+
+* W wielu przypadkach zadane pytanie dotyczy rozwiązania wymyślonego przez użytkownika, ale może istnieć **lepsze** rozwiązanie. Jeśli dokładnie zrozumiesz problem i przypadek użycia, być może będziesz mógł zaproponować lepsze **alternatywne rozwiązanie**.
+
+* Jeśli nie rozumiesz pytania, poproś o więcej **szczegółów**.
+
+### Odtwórz problem
+
+W większości przypadków problem wynika z **autorskiego kodu** osoby pytającej.
+
+Często pytający umieszczają tylko fragment kodu, niewystarczający do **odtworzenia problemu**.
+
+* Możesz poprosić ich o dostarczenie <a href="https://stackoverflow.com/help/minimal-reproducible-example" class="external-link" target="_blank">minimalnego, odtwarzalnego przykładu</a>, który możesz **skopiować i wkleić** i uruchomić lokalnie, aby zobaczyć ten sam błąd lub zachowanie, które widzą, lub lepiej zrozumieć ich przypadki użycia.
+
+* Jeśli jesteś wyjątkowo pomocny, możesz spróbować **stworzyć taki przykład** samodzielnie, opierając się tylko na opisie problemu. Miej na uwadze, że może to zająć dużo czasu i lepiej może być najpierw poprosić ich o wyjaśnienie problemu.
+
+### Proponuj rozwiązania
+
+* Po zrozumieniu pytania możesz podać im możliwą **odpowiedź**.
+
+* W wielu przypadkach lepiej zrozumieć ich **podstawowy problem lub przypadek użycia**, ponieważ może istnieć lepszy sposób rozwiązania niż to, co próbują zrobić.
+
+### Poproś o zamknięcie
+
+Jeśli odpowiedzą, jest duża szansa, że rozwiązałeś ich problem, gratulacje, **jesteś bohaterem**! 🦸
+
+* Jeśli Twoja odpowiedź rozwiązała problem, możesz poprosić o:
+
+    * W Dyskusjach na GitHubie: oznaczenie komentarza jako **odpowiedź**.
+    * W Problemach na GitHubie: **zamknięcie** problemu.
+
+## Obserwuj repozytorium na GitHubie
+
+Możesz "obserwować" FastAPI na GitHubie (klikając przycisk "obserwuj" w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Jeśli wybierzesz "Obserwuj" zamiast "Tylko wydania", otrzymasz powiadomienia, gdy ktoś utworzy nowy problem lub pytanie. Możesz również określić, że chcesz być powiadamiany tylko o nowych problemach, dyskusjach, PR-ach itp.
+
+Następnie możesz spróbować pomóc rozwiązać te problemy.
+
+## Zadawaj pytania
+
+Możesz <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">utworzyć nowe pytanie</a> w repozytorium na GitHubie, na przykład aby:
+
+* Zadać **pytanie** lub zapytać o **problem**.
+* Zaproponować nową **funkcję**.
+
+**Uwaga**: jeśli to zrobisz, poproszę Cię również o pomoc innym. 😉
+
+## Przeglądaj Pull Requesty
+
+Możesz pomóc mi w przeglądaniu pull requestów autorstwa innych osób.
+
+Jak wcześniej wspomniałem, postaraj się być jak najbardziej życzliwy. 🤗
+
+---
+
+Oto, co warto mieć na uwadze podczas oceny pull requestu:
+
+### Zrozum problem
+
+* Najpierw upewnij się, że **rozumiesz problem**, który próbuje rozwiązać pull request. Może być osadzony w większym kontekście w GitHubowej dyskusji lub problemie.
+
+* Jest też duża szansa, że pull request nie jest konieczny, ponieważ problem można rozwiązać w **inny sposób**. Wtedy możesz to zasugerować lub o to zapytać.
+
+### Nie martw się stylem
+
+* Nie przejmuj się zbytnio rzeczami takimi jak style wiadomości commitów, przy wcielaniu pull requesta łączę commity i modyfikuję opis sumarycznego commita ręcznie.
+
+* Nie przejmuj się również stylem kodu, automatyczne narzędzia w repozytorium sprawdzają to samodzielnie.
+
+A jeśli istnieje jakaś konkretna potrzeba dotycząca stylu lub spójności, sam poproszę o zmiany lub dodam commity z takimi zmianami.
+
+### Sprawdź kod
+
+* Przeczytaj kod, zastanów się czy ma sens, **uruchom go lokalnie** i potwierdź czy faktycznie rozwiązuje problem.
+
+* Następnie dodaj **komentarz** z informacją o tym, że sprawdziłeś kod, dzięki temu będę miał pewność, że faktycznie go sprawdziłeś.
+
+!!! info
+    Niestety, nie mogę ślepo ufać PR-om, nawet jeśli mają kilka zatwierdzeń.
+
+    Kilka razy zdarzyło się, że PR-y miały 3, 5 lub więcej zatwierdzeń (prawdopodobnie dlatego, że opis obiecuje rozwiązanie ważnego problemu), ale gdy sam sprawdziłem danego PR-a, okazał się być zbugowany lub nie rozwiązywał problemu, który rzekomo miał rozwiązywać. 😅
+
+    Dlatego tak ważne jest, abyś faktycznie przeczytał i uruchomił kod oraz napisał w komentarzu, że to zrobiłeś. 🤓
+
+* Jeśli PR można uprościć w jakiś sposób, możesz o to poprosić, ale nie ma potrzeby być zbyt wybrednym, może być wiele subiektywnych punktów widzenia (a ja też będę miał swój 🙈), więc lepiej żebyś skupił się na kluczowych rzeczach.
+
+### Testy
+
+* Pomóż mi sprawdzić, czy PR ma **testy**.
+
+* Sprawdź, czy testy **nie przechodzą** przed PR. 🚨
+
+* Następnie sprawdź, czy testy **przechodzą** po PR. ✅
+
+* Wiele PR-ów nie ma testów, możesz **przypomnieć** im o dodaniu testów, a nawet **zaproponować** samemu jakieś testy. To jedna z rzeczy, które pochłaniają najwięcej czasu i możesz w tym bardzo pomóc.
+
+* Następnie skomentuj również to, czego spróbowałeś, wtedy będę wiedział, że to sprawdziłeś. 🤓
+
+## Utwórz Pull Request
+
+Możesz [wnieść wkład](contributing.md){.internal-link target=_blank} do kodu źródłowego za pomocą Pull Requestu, na przykład:
+
+* Naprawić literówkę, którą znalazłeś w dokumentacji.
+* Podzielić się artykułem, filmem lub podcastem, który stworzyłeś lub znalazłeś na temat FastAPI, <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">edytując ten plik</a>.
+    * Upewnij się, że dodajesz swój link na początku odpowiedniej sekcji.
+* Pomóc w [tłumaczeniu dokumentacji](contributing.md#translations){.internal-link target=_blank} na Twój język.
+    * Możesz również pomóc w weryfikacji tłumaczeń stworzonych przez innych.
+* Zaproponować nowe sekcje dokumentacji.
+* Naprawić istniejący problem/błąd.
+    * Upewnij się, że dodajesz testy.
+* Dodać nową funkcję.
+    * Upewnij się, że dodajesz testy.
+    * Upewnij się, że dodajesz dokumentację, jeśli jest to istotne.
+
+## Pomóż w utrzymaniu FastAPI
+
+Pomóż mi utrzymać **FastAPI**! 🤓
+
+Jest wiele pracy do zrobienia, a w większości przypadków **TY** możesz to zrobić.
+
+Główne zadania, które możesz wykonać teraz to:
+
+* [Pomóc innym z pytaniami na GitHubie](#help-others-with-questions-in-github){.internal-link target=_blank} (zobacz sekcję powyżej).
+* [Oceniać Pull Requesty](#review-pull-requests){.internal-link target=_blank} (zobacz sekcję powyżej).
+
+Te dwie czynności **zajmują najwięcej czasu**. To główna praca związana z utrzymaniem FastAPI.
+
+Jeśli możesz mi w tym pomóc, **pomożesz mi utrzymać FastAPI** i zapewnisz że będzie **rozwijać się szybciej i lepiej**. 🚀
+
+## Dołącz do czatu
+
+Dołącz do 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">serwera czatu na Discordzie</a> 👥 i spędzaj czas z innymi w społeczności FastAPI.
+
+!!! wskazówka
+    Jeśli masz pytania, zadaj je w <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">Dyskusjach na GitHubie</a>, jest dużo większa szansa, że otrzymasz pomoc od [Ekspertów FastAPI](fastapi-people.md#experts){.internal-link target=_blank}.
+
+    Używaj czatu tylko do innych ogólnych rozmów.
+
+### Nie zadawaj pytań na czacie
+
+Miej na uwadze, że ponieważ czaty pozwalają na bardziej "swobodną rozmowę", łatwo jest zadawać pytania, które są zbyt ogólne i trudniejsze do odpowiedzi, więc możesz nie otrzymać odpowiedzi.
+
+Na GitHubie szablon poprowadzi Cię do napisania odpowiedniego pytania, dzięki czemu łatwiej uzyskasz dobrą odpowiedź, a nawet rozwiążesz problem samodzielnie, zanim zapytasz. Ponadto na GitHubie mogę się upewnić, że zawsze odpowiadam na wszystko, nawet jeśli zajmuje to trochę czasu. Osobiście nie mogę tego zrobić z systemami czatu. 😅
+
+Rozmów w systemach czatu nie można tak łatwo przeszukiwać, jak na GitHubie, więc pytania i odpowiedzi mogą zaginąć w rozmowie. A tylko te na GitHubie liczą się do zostania [Ekspertem FastAPI](fastapi-people.md#experts){.internal-link target=_blank}, więc najprawdopodobniej otrzymasz więcej uwagi na GitHubie.
+
+Z drugiej strony w systemach czatu są tysiące użytkowników, więc jest duża szansa, że znajdziesz tam kogoś do rozmowy, prawie w każdej chwili. 😄
+
+## Wspieraj autora
+
+Możesz również finansowo wesprzeć autora (mnie) poprzez <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">sponsoring na GitHubie</a>.
+
+Tam możesz postawić mi kawę ☕️ aby podziękować. 😄
+
+Możesz także zostać srebrnym lub złotym sponsorem FastAPI. 🏅🎉
+
+## Wspieraj narzędzia, które napędzają FastAPI
+
+Jak widziałeś w dokumentacji, FastAPI stoi na ramionach gigantów, Starlette i Pydantic.
+
+Możesz również wesprzeć:
+
+* <a href="https://github.com/sponsors/samuelcolvin" class="external-link" target="_blank">Samuel Colvin (Pydantic)</a>
+* <a href="https://github.com/sponsors/encode" class="external-link" target="_blank">Encode (Starlette, Uvicorn)</a>
+
+---
+
+Dziękuję! 🚀
diff --git a/docs/pl/docs/index.md b/docs/pl/docs/index.md
index bade7a88c..43a20383c 100644
--- a/docs/pl/docs/index.md
+++ b/docs/pl/docs/index.md
@@ -106,7 +106,7 @@ Jeżeli tworzysz aplikacje <abbr title="aplikacja z interfejsem konsolowym">CLI<
 
 ## Wymagania
 
-Python 3.7+
+Python 3.8+
 
 FastAPI oparty jest na:
 
@@ -321,7 +321,7 @@ Robisz to tak samo jak ze standardowymi typami w Pythonie.
 
 Nie musisz sie uczyć żadnej nowej składni, metod lub klas ze specyficznych bibliotek itp.
 
-Po prostu standardowy **Python 3.6+**.
+Po prostu standardowy **Python 3.8+**.
 
 Na przykład, dla danych typu `int`:
 
diff --git a/docs/pt/docs/deployment/deta.md b/docs/pt/docs/deployment/deta.md
deleted file mode 100644
index 9271bba42..000000000
--- a/docs/pt/docs/deployment/deta.md
+++ /dev/null
@@ -1,258 +0,0 @@
-# Implantação FastAPI na Deta
-
-Nessa seção você aprenderá sobre como realizar a implantação de uma aplicação **FastAPI** na <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> utilizando o plano gratuito. 🎁
-
-Isso tudo levará aproximadamente **10 minutos**.
-
-!!! info "Informação"
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> é uma  patrocinadora do **FastAPI**. 🎉
-
-## Uma aplicação **FastAPI** simples
-
-* Crie e entre em um diretório para a sua aplicação, por exemplo, `./fastapideta/`.
-
-### Código FastAPI
-
-* Crie o arquivo `main.py` com:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Requisitos
-
-Agora, no mesmo diretório crie o arquivo `requirements.txt` com:
-
-```text
-fastapi
-```
-
-!!! tip "Dica"
-    Você não precisa instalar Uvicorn para realizar a implantação na Deta, embora provavelmente queira instalá-lo para testar seu aplicativo localmente.
-
-### Estrutura de diretório
-
-Agora você terá o diretório `./fastapideta/` com dois arquivos:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Crie uma conta gratuita na Deta
-
-Agora crie <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">uma conta gratuita na Deta</a>, você precisará apenas de um email e senha.
-
-Você nem precisa de um cartão de crédito.
-
-## Instale a CLI
-
-Depois de ter sua conta criada, instale Deta <abbr title="Interface de Linha de Comando">CLI</abbr>:
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-Após a instalação, abra um novo terminal para que a CLI seja detectada.
-
-Em um novo terminal, confirme se foi instalado corretamente com:
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip "Dica"
-    Se você tiver problemas ao instalar a CLI, verifique a <a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">documentação oficial da Deta</a>.
-
-## Login pela CLI
-
-Agora faça login na Deta pela CLI com:
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-Isso abrirá um navegador da Web e autenticará automaticamente.
-
-## Implantação com Deta
-
-Em seguida, implante seu aplicativo com a Deta CLI:
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-Você verá uma mensagem JSON semelhante a:
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip "Dica"
-    Sua implantação terá um URL `"endpoint"` diferente.
-
-## Confira
-
-Agora, abra seu navegador na URL do `endpoint`. No exemplo acima foi `https://qltnci.deta.dev`, mas o seu será diferente.
-
-Você verá a resposta JSON do seu aplicativo FastAPI:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-Agora vá para o `/docs` da sua API, no exemplo acima seria `https://qltnci.deta.dev/docs`.
-
-Ele mostrará sua documentação como:
-
-<img src="/img/deployment/deta/image01.png">
-
-## Permitir acesso público
-
-Por padrão, a Deta lidará com a autenticação usando cookies para sua conta.
-
-Mas quando estiver pronto, você pode torná-lo público com:
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-Agora você pode compartilhar essa URL com qualquer pessoa e elas conseguirão acessar sua API. 🚀
-
-## HTTPS
-
-Parabéns! Você realizou a implantação do seu app FastAPI na Deta! 🎉 🍰
-
-Além disso, observe que a Deta lida corretamente com HTTPS para você, para que você não precise cuidar disso e tenha a certeza de que seus clientes terão uma conexão criptografada segura. ✅ 🔒
-
-## Verifique o Visor
-
-Na UI da sua documentação (você estará em um URL como `https://qltnci.deta.dev/docs`) envie um request para *operação de rota* `/items/{item_id}`.
-
-Por exemplo com ID `5`.
-
-Agora vá para <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.
-
-Você verá que há uma seção à esquerda chamada <abbr title="it comes from Micro(server)">"Micros"</abbr> com cada um dos seus apps.
-
-Você verá uma aba com "Detalhes", e também a aba "Visor", vá para "Visor".
-
-Lá você pode inspecionar as solicitações recentes enviadas ao seu aplicativo.
-
-Você também pode editá-los e reproduzi-los novamente.
-
-<img src="/img/deployment/deta/image02.png">
-
-## Saiba mais
-
-Em algum momento, você provavelmente desejará armazenar alguns dados para seu aplicativo de uma forma que persista ao longo do tempo. Para isso você pode usar <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a>, que também tem um generoso **nível gratuito**.
-
-Você também pode ler mais na <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">documentação da Deta</a>.
-
-## Conceitos de implantação
-
-Voltando aos conceitos que discutimos em [Deployments Concepts](./concepts.md){.internal-link target=_blank}, veja como cada um deles seria tratado com a Deta:
-
-* **HTTPS**: Realizado pela Deta, eles fornecerão um subdomínio e lidarão com HTTPS automaticamente.
-* **Executando na inicialização**: Realizado pela Deta, como parte de seu serviço.
-* **Reinicialização**: Realizado pela Deta, como parte de seu serviço.
-* **Replicação**: Realizado pela Deta, como parte de seu serviço.
-* **Memória**: Limite predefinido pela Deta, você pode contatá-los para aumentá-lo.
-* **Etapas anteriores a inicialização**: Não suportado diretamente, você pode fazê-lo funcionar com o sistema Cron ou scripts adicionais.
-
-!!! note "Nota"
-    O Deta foi projetado para facilitar (e gratuitamente) a implantação rápida de aplicativos simples.
-
-    Ele pode simplificar vários casos de uso, mas, ao mesmo tempo, não suporta outros, como o uso de bancos de dados externos (além do próprio sistema de banco de dados NoSQL da Deta), máquinas virtuais personalizadas, etc.
-
-    Você pode ler mais detalhes na <a href="https://docs.deta.sh/docs/micros/about/" class="external-link" target="_blank">documentação da Deta</a> para ver se é a escolha certa para você.
diff --git a/docs/pt/docs/external-links.md b/docs/pt/docs/external-links.md
index 6ec6c3a27..77ec32351 100644
--- a/docs/pt/docs/external-links.md
+++ b/docs/pt/docs/external-links.md
@@ -9,70 +9,21 @@ Aqui tem uma lista, incompleta, de algumas delas.
 !!! tip "Dica"
     Se você tem um artigo, projeto, ferramenta ou qualquer coisa relacionada ao **FastAPI** que ainda não está listada aqui, crie um <a href="https://github.com/tiangolo/fastapi/edit/master/docs/external-links.md" class="external-link" target="_blank">_Pull Request_ adicionando ele</a>.
 
-## Artigos
+{% for section_name, section_content in external_links.items() %}
 
-### Inglês
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
+
+### {{ 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>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Japonês
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Vietnamita
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Russo
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Alemão
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Podcasts
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Palestras
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
 
 ## Projetos
 
diff --git a/docs/pt/docs/features.md b/docs/pt/docs/features.md
index bd0db8e76..822992c5b 100644
--- a/docs/pt/docs/features.md
+++ b/docs/pt/docs/features.md
@@ -25,7 +25,7 @@ Documentação interativa da API e navegação _web_ da interface de usuário. C
 
 ### Apenas Python moderno
 
-Tudo é baseado no padrão das declarações de **tipos do Python 3.6** (graças ao Pydantic). Nenhuma sintaxe nova para aprender. Apenas o padrão moderno do Python.
+Tudo é baseado no padrão das declarações de **tipos do Python 3.8** (graças ao Pydantic). Nenhuma sintaxe nova para aprender. Apenas o padrão moderno do Python.
 
 Se você precisa refrescar a memória rapidamente sobre como usar tipos do Python (mesmo que você não use o FastAPI), confira esse rápido tutorial: [Tipos do Python](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/pt/docs/help-fastapi.md b/docs/pt/docs/help-fastapi.md
index d82ce3414..d04905197 100644
--- a/docs/pt/docs/help-fastapi.md
+++ b/docs/pt/docs/help-fastapi.md
@@ -114,8 +114,6 @@ do FastAPI.
 
     Use o chat apenas para outro tipo de assunto.
 
-Também existe o <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">chat do Gitter</a>, porém ele não possuí canais e recursos avançados, conversas são mais engessadas, por isso o Discord é mais recomendado.
-
 ### Não faça perguntas no chat
 
 Tenha em mente que os chats permitem uma "conversa mais livre", dessa forma é muito fácil fazer perguntas que são muito genéricas e dificeís de responder, assim você pode acabar não sendo respondido.
diff --git a/docs/pt/docs/index.md b/docs/pt/docs/index.md
index 591e7f3d4..d1e64b3b9 100644
--- a/docs/pt/docs/index.md
+++ b/docs/pt/docs/index.md
@@ -24,7 +24,7 @@
 
 ---
 
-FastAPI é um moderno e rápido (alta performance) _framework web_ para construção de APIs com Python 3.6 ou superior, baseado nos _type hints_ padrões do Python.
+FastAPI é um moderno e rápido (alta performance) _framework web_ para construção de APIs com Python 3.8 ou superior, baseado nos _type hints_ padrões do Python.
 
 Os recursos chave são:
 
@@ -100,7 +100,7 @@ Se você estiver construindo uma aplicação <abbr title="Command Line Interface
 
 ## Requisitos
 
-Python 3.7+
+Python 3.8+
 
 FastAPI está nos ombros de gigantes:
 
@@ -316,7 +316,7 @@ Você faz com tipos padrão do Python moderno.
 
 Você não terá que aprender uma nova sintaxe, métodos ou classes de uma biblioteca específica etc.
 
-Apenas **Python 3.6+** padrão.
+Apenas **Python 3.8+** padrão.
 
 Por exemplo, para um `int`:
 
diff --git a/docs/pt/docs/tutorial/body-multiple-params.md b/docs/pt/docs/tutorial/body-multiple-params.md
index 22f5856a6..0eaa9664c 100644
--- a/docs/pt/docs/tutorial/body-multiple-params.md
+++ b/docs/pt/docs/tutorial/body-multiple-params.md
@@ -14,7 +14,7 @@ E você também pode declarar parâmetros de corpo como opcionais, definindo o v
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001.py!}
@@ -44,7 +44,7 @@ Mas você pode também declarar múltiplos parâmetros de corpo, por exemplo, `i
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -87,7 +87,7 @@ Se você declará-lo como é, porque é um valor singular, o **FastAPI** assumir
 
 Mas você pode instruir o **FastAPI** para tratá-lo como outra chave do corpo usando `Body`:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial003.py!}
@@ -143,7 +143,7 @@ Por exemplo:
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="27"
     {!> ../../../docs_src/body_multiple_params/tutorial004.py!}
@@ -172,7 +172,7 @@ como em:
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17"
     {!> ../../../docs_src/body_multiple_params/tutorial005.py!}
diff --git a/docs/pt/docs/tutorial/encoder.md b/docs/pt/docs/tutorial/encoder.md
index bb4483fdc..b9bfbf63b 100644
--- a/docs/pt/docs/tutorial/encoder.md
+++ b/docs/pt/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@ A função recebe um objeto, como um modelo Pydantic e retorna uma versão compa
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/pt/docs/tutorial/extra-models.md b/docs/pt/docs/tutorial/extra-models.md
index dd5407eb2..1343a3ae4 100644
--- a/docs/pt/docs/tutorial/extra-models.md
+++ b/docs/pt/docs/tutorial/extra-models.md
@@ -17,7 +17,7 @@ Isso é especialmente o caso para modelos de usuários, porque:
 
 Aqui está uma ideia geral de como os modelos poderiam parecer com seus campos de senha e os lugares onde são usados:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -158,7 +158,7 @@ Toda conversão de dados, validação, documentação, etc. ainda funcionará no
 
 Dessa forma, podemos declarar apenas as diferenças entre os modelos (com `password` em texto claro, com `hashed_password` e sem senha):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -181,7 +181,7 @@ Para fazer isso, use a dica de tipo padrão do Python <a href="https://docs.pyth
 !!! note
     Ao definir um <a href="https://pydantic-docs.helpmanual.io/usage/types/#unions" class="external-link" target="_blank">`Union`</a>, inclua o tipo mais específico primeiro, seguido pelo tipo menos específico. No exemplo abaixo, o tipo mais específico `PlaneItem` vem antes de `CarItem` em `Union[PlaneItem, CarItem]`.
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -213,7 +213,7 @@ Da mesma forma, você pode declarar respostas de listas de objetos.
 
 Para isso, use o padrão Python `typing.List` (ou simplesmente `list` no Python 3.9 e superior):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -233,7 +233,7 @@ Isso é útil se você não souber os nomes de campo / atributo válidos (que se
 
 Neste caso, você pode usar `typing.Dict` (ou simplesmente dict no Python 3.9 e superior):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/pt/docs/tutorial/header-params.md b/docs/pt/docs/tutorial/header-params.md
index bc8843327..4bdfb7e9c 100644
--- a/docs/pt/docs/tutorial/header-params.md
+++ b/docs/pt/docs/tutorial/header-params.md
@@ -12,7 +12,7 @@ Primeiro importe `Header`:
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/header_params/tutorial001.py!}
@@ -30,7 +30,7 @@ O primeiro valor é o valor padrão, você pode passar todas as validações adi
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/header_params/tutorial001.py!}
@@ -66,7 +66,7 @@ Se por algum motivo você precisar desabilitar a conversão automática de subli
     {!> ../../../docs_src/header_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial002.py!}
@@ -97,7 +97,7 @@ Por exemplo, para declarar um cabeçalho de `X-Token` que pode aparecer mais de
     {!> ../../../docs_src/header_params/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/header_params/tutorial003.py!}
diff --git a/docs/pt/docs/tutorial/path-operation-configuration.md b/docs/pt/docs/tutorial/path-operation-configuration.md
index e0a23f665..13a87240f 100644
--- a/docs/pt/docs/tutorial/path-operation-configuration.md
+++ b/docs/pt/docs/tutorial/path-operation-configuration.md
@@ -13,7 +13,7 @@ Você pode passar diretamente o código `int`, como `404`.
 
 Mas se você não se lembrar o que cada código numérico significa, pode usar as constantes de atalho em `status`:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="3  17"
     {!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
@@ -42,7 +42,7 @@ Esse código de status será usado na resposta e será adicionado ao esquema Ope
 
 Você pode adicionar tags para sua *operação de rota*, passe o parâmetro `tags` com uma `list` de `str` (comumente apenas um `str`):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="17  22  27"
     {!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
@@ -80,7 +80,7 @@ Nestes casos, pode fazer sentido armazenar as tags em um `Enum`.
 
 Você pode adicionar um `summary` e uma `description`:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="20-21"
     {!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
@@ -104,7 +104,7 @@ Como as descrições tendem a ser longas e cobrir várias linhas, você pode dec
 
 Você pode escrever <a href="https://en.wikipedia.org/wiki/Markdown" class="external-link" target="_blank">Markdown</a> na docstring, ele será interpretado e exibido corretamente (levando em conta a indentação da docstring).
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="19-27"
     {!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
@@ -131,7 +131,7 @@ Ela será usada nas documentações interativas:
 
 Você pode especificar a descrição da resposta com o parâmetro `response_description`:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
diff --git a/docs/pt/docs/tutorial/path-params-numeric-validations.md b/docs/pt/docs/tutorial/path-params-numeric-validations.md
index ec9b74b30..eb0d31dc3 100644
--- a/docs/pt/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/pt/docs/tutorial/path-params-numeric-validations.md
@@ -12,7 +12,7 @@ Primeiro, importe `Path` de `fastapi`:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
@@ -30,7 +30,7 @@ Por exemplo para declarar um valor de metadado `title` para o parâmetro de rota
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
diff --git a/docs/pt/docs/tutorial/path-params.md b/docs/pt/docs/tutorial/path-params.md
index 5de3756ed..cd8c18858 100644
--- a/docs/pt/docs/tutorial/path-params.md
+++ b/docs/pt/docs/tutorial/path-params.md
@@ -236,7 +236,6 @@ Então, você poderia usar ele com:
 Com o **FastAPI**, usando as declarações de tipo do Python, você obtém:
 
 * Suporte no editor: verificação de erros, e opção de autocompletar, etc.
-* Parsing de dados
 * "<abbr title="convertendo uma string que vem de um request HTTP em dado Python">Parsing</abbr>" de dados
 * Validação de dados
 * Anotação da API e documentação automática
diff --git a/docs/pt/docs/tutorial/query-params.md b/docs/pt/docs/tutorial/query-params.md
index 3ada4fd21..08bb99dbc 100644
--- a/docs/pt/docs/tutorial/query-params.md
+++ b/docs/pt/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ Da mesma forma, você pode declarar parâmetros de consulta opcionais, definindo
     {!> ../../../docs_src/query_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial002.py!}
@@ -91,7 +91,7 @@ Você também pode declarar tipos `bool`, e eles serão convertidos:
     {!> ../../../docs_src/query_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial003.py!}
@@ -143,7 +143,7 @@ Eles serão detectados pelo nome:
     {!> ../../../docs_src/query_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  10"
     {!> ../../../docs_src/query_params/tutorial004.py!}
@@ -209,7 +209,7 @@ E claro, você pode definir alguns parâmetros como obrigatórios, alguns possui
     {!> ../../../docs_src/query_params/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params/tutorial006.py!}
diff --git a/docs/ru/docs/deployment/docker.md b/docs/ru/docs/deployment/docker.md
new file mode 100644
index 000000000..f045ca944
--- /dev/null
+++ b/docs/ru/docs/deployment/docker.md
@@ -0,0 +1,700 @@
+# FastAPI и Docker-контейнеры
+
+При развёртывании приложений FastAPI, часто начинают с создания **образа контейнера на основе Linux**. Обычно для этого используют <a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a>. Затем можно развернуть такой контейнер на сервере одним из нескольких способов.
+
+Использование контейнеров на основе Linux имеет ряд преимуществ, включая  **безопасность**, **воспроизводимость**, **простоту** и прочие.
+
+!!! tip "Подсказка"
+    Торопитесь или уже знакомы с этой технологией? Перепрыгните на раздел [Создать Docker-образ для FastAPI 👇](#docker-fastapi)
+
+<details>
+<summary>Развернуть Dockerfile 👀</summary>
+
+```Dockerfile
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+COPY ./app /code/app
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+
+# Если используете прокси-сервер, такой как Nginx или Traefik, добавьте --proxy-headers
+# CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80", "--proxy-headers"]
+```
+
+</details>
+
+## Что такое "контейнер"
+
+Контейнеризация - это **легковесный** способ упаковать приложение, включая все его зависимости и необходимые файлы, чтобы изолировать его от других контейнеров (других приложений и компонентов) работающих на этой же системе.
+
+Контейнеры, основанные на Linux, запускаются используя ядро Linux хоста (машины, виртуальной машины, облачного сервера и т.п.). Это значит, что они очень легковесные (по сравнению с полноценными виртуальными машинами, полностью эмулирующими работу операционной системы).
+
+Благодаря этому, контейнеры потребляют **малое количество ресурсов**, сравнимое с процессом запущенным напрямую (виртуальная машина потребует гораздо больше ресурсов).
+
+Контейнеры также имеют собственные запущенные **изолированные** процессы (но часто только один процесс), файловую систему и сеть, что упрощает развёртывание, разработку, управление доступом и т.п.
+
+## Что такое "образ контейнера"
+
+Для запуска **контейнера** нужен **образ контейнера**.
+
+Образ контейнера - это **замороженная** версия всех файлов, переменных окружения, программ и команд по умолчанию, необходимых для работы приложения. **Замороженный** - означает, что **образ** не запущен и не выполняется, это всего лишь упакованные вместе файлы и метаданные.
+
+В отличие от **образа контейнера**, хранящего неизменное содержимое, под термином **контейнер** подразумевают запущенный образ, то есть объёкт, который **исполняется**.
+
+Когда **контейнер** запущен (на основании **образа**), он может создавать и изменять файлы, переменные окружения и т.д. Эти изменения будут существовать только внутри контейнера, но не будут сохраняться в образе контейнера (не будут сохранены на диск).
+
+Образ контейнера можно сравнить с файлом, содержащем **программу**, например, как файл `main.py`.
+
+И **контейнер** (в отличие от **образа**) - это на самом деле выполняемый экземпляр образа, примерно как **процесс**. По факту, контейнер запущен только когда запущены его процессы (чаще, всего один процесс) и остановлен, когда запущенных процессов нет.
+
+## Образы контейнеров
+
+Docker является одним оз основных инструментов для создания **образов** и  **контейнеров** и управления ими.
+
+Существует общедоступный <a href="https://hub.docker.com/" class="external-link" target="_blank">Docker Hub</a> с подготовленными **официальными образами** многих инструментов, окружений, баз данных и приложений.
+
+К примеру, есть официальный <a href="https://hub.docker.com/_/python" class="external-link" target="_blank">образ Python</a>.
+
+Также там представлены и другие полезные образы, такие как базы данных:
+
+* <a href="https://hub.docker.com/_/postgres" class="external-link" target="_blank">PostgreSQL</a>
+* <a href="https://hub.docker.com/_/mysql" class="external-link" target="_blank">MySQL</a>
+* <a href="https://hub.docker.com/_/mongo" class="external-link" target="_blank">MongoDB</a>
+* <a href="https://hub.docker.com/_/redis" class="external-link" target="_blank">Redis</a>
+
+и т.п.
+
+Использование подготовленных образов значительно упрощает **комбинирование** и использование разных инструментов. Например, Вы можете попытаться использовать новую базу данных. В большинстве случаев можно использовать **официальный образ** и всего лишь указать переменные окружения.
+
+Таким образом, Вы можете изучить, что такое контейнеризация и Docker, и использовать полученные знания с разными инструментами и компонентами.
+
+Так, Вы можете запустить одновременно **множество контейнеров** с базой данных, Python-приложением, веб-сервером, React-приложением и соединить их вместе через внутреннюю сеть.
+
+Все системы управления контейнерами (такие, как Docker или Kubernetes) имеют встроенные возможности для организации такого сетевого взаимодействия.
+
+## Контейнеры и процессы
+
+Обычно **образ контейнера** содержит метаданные предустановленной программы или команду, которую следует выполнить при запуске **контейнера**. Также он может содержать параметры, передаваемые предустановленной программе. Похоже на то, как если бы Вы запускали такую программу через терминал.
+
+Когда **контейнер** запущен, он будет выполнять прописанные в нём команды и программы. Но Вы можете изменить его так, чтоб он выполнял другие команды и программы.
+
+Контейнер буде работать до тех пор, пока выполняется его **главный процесс** (команда или программа).
+
+В контейнере обычно выполняется **только один процесс**, но от его имени можно запустить другие процессы, тогда в этом же в контейнере будет выполняться **множество процессов**.
+
+Контейнер не считается запущенным, если в нём **не выполняется хотя бы один процесс**. Если главный процесс остановлен, значит и контейнер остановлен.
+
+## Создать Docker-образ для FastAPI
+
+Что ж, давайте ужё создадим что-нибудь! 🚀
+
+Я покажу Вам, как собирать **Docker-образ** для FastAPI **с нуля**, основываясь на **официальном образе Python**.
+
+Такой подход сгодится для **большинства случаев**, например:
+
+* Использование с **Kubernetes** или аналогичным инструментом
+* Запуск в **Raspberry Pi**
+* Использование в облачных сервисах, запускающих образы контейнеров для Вас и т.п.
+
+### Установить зависимости
+
+Обычно Вашему приложению необходимы **дополнительные библиотеки**, список которых находится в отдельном файле.
+
+На название и содержание такого файла влияет выбранный Вами инструмент **установки** этих библиотек (зависимостей).
+
+Чаще всего это простой файл `requirements.txt` с построчным перечислением библиотек и их версий.
+
+При этом Вы, для выбора версий, будете использовать те же идеи, что упомянуты на странице [О версиях FastAPI](./versions.md){.internal-link target=_blank}.
+
+Ваш файл `requirements.txt` может выглядеть как-то так:
+
+```
+fastapi>=0.68.0,<0.69.0
+pydantic>=1.8.0,<2.0.0
+uvicorn>=0.15.0,<0.16.0
+```
+
+Устанавливать зависимости проще всего с помощью `pip`:
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+Successfully installed fastapi pydantic uvicorn
+```
+
+</div>
+
+!!! info "Информация"
+    Существуют и другие инструменты управления зависимостями.
+
+    В этом же разделе, но позже, я покажу Вам пример использования Poetry. 👇
+
+### Создать приложение **FastAPI**
+
+* Создайте директорию `app` и перейдите в неё.
+* Создайте пустой файл `__init__.py`.
+* Создайте файл `main.py` и заполните его:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+### Dockerfile
+
+В этой же директории создайте файл `Dockerfile` и заполните его:
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9
+
+# (2)
+WORKDIR /code
+
+# (3)
+COPY ./requirements.txt /code/requirements.txt
+
+# (4)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (5)
+COPY ./app /code/app
+
+# (6)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. Начните с официального образа Python, который будет основой для образа приложения.
+
+2. Укажите, что в дальнейшем команды запускаемые в контейнере, будут выполняться в директории `/code`.
+
+    Инструкция создаст эту директорию внутри контейнера и мы поместим в неё файл `requirements.txt` и директорию `app`.
+
+3. Скопируете файл с зависимостями из текущей директории в `/code`.
+
+    Сначала копируйте **только** файл с зависимостями.
+
+    Этот файл **изменяется довольно редко**, Docker ищет изменения при постройке образа и если не находит, то использует **кэш**, в котором хранятся предыдущии версии сборки образа.
+
+4. Установите библиотеки перечисленные в файле с зависимостями.
+
+    Опция `--no-cache-dir` указывает `pip` не сохранять загружаемые библиотеки на локальной машине для использования их в случае повторной загрузки. В контейнере, в случае пересборки этого шага, они всё равно будут удалены.
+
+    !!! note "Заметка"
+        Опция `--no-cache-dir` нужна только для `pip`, она никак не влияет на Docker или контейнеры.
+
+    Опция `--upgrade` указывает `pip` обновить библиотеки, емли они уже установлены.
+
+    Ка и в предыдущем шаге с копированием файла, этот шаг также будет использовать **кэш Docker** в случае отсутствия изменений.
+
+    Использрвание кэша, особенно на этом шаге, позволит Вам **сэкономить** кучу времени при повторной сборке образа, так как зависимости будут сохранены в кеше, а не **загружаться и устанавливаться каждый раз**.
+
+5. Скопируйте директорию `./app` внутрь директории `/code` (в контейнере).
+
+    Так как в этой директории расположен код, который **часто изменяется**, то использование **кэша** на этом шаге будет наименее эффективно, а значит лучше поместить этот шаг **ближе к концу** `Dockerfile`, дабы не терять выгоду от оптимизации предыдущих шагов.
+
+6. Укажите **команду**, запускающую сервер `uvicorn`.
+
+    `CMD` принимает список строк, разделённых запятыми, но при выполнении объединит их через пробел, собрав из них одну команду, которую Вы могли бы написать в терминале.
+
+    Эта команда будет выполнена в **текущей рабочей директории**, а именно в директории `/code`, котоая указана командой `WORKDIR /code`.
+
+    Так как команда выполняется внутрии директории `/code`, в которую мы поместили папку `./app` с приложением, то **Uvicorn** сможет найти и **импортировать** объект `app` из файла `app.main`.
+
+!!! tip "Подсказка"
+    Если ткнёте на кружок с плюсом, то увидите пояснения. 👆
+
+На данном этапе структура проекта должны выглядеть так:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   └── main.py
+├── Dockerfile
+└── requirements.txt
+```
+
+#### Использование прокси-сервера
+
+Если Вы запускаете контейнер за прокси-сервером завершения TLS (балансирующего нагрузку), таким как Nginx или Traefik, добавьте опцию `--proxy-headers`, которая укажет Uvicorn, что он работает позади прокси-сервера и может доверять заголовкам отправляемым им.
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+#### Кэш Docker'а
+
+В нашем `Dockerfile` использована полезная хитрость, когда сначала копируется **только файл с зависимостями**, а не вся папка с кодом приложения.
+
+```Dockerfile
+COPY ./requirements.txt /code/requirements.txt
+```
+
+Docker и подобные ему инструменты **создают** образы контейнеров **пошагово**, добавляя **один слой над другим**, начиная с первой строки `Dockerfile` и добавляя файлы, создаваемые при выполнении каждой инструкции из `Dockerfile`.
+
+При создании образа используется **внутренний кэш** и если в файлах нет изменений с момента последней сборки образа, то будет **переиспользован** ранее созданный слой образа, а не повторное копирование файлов и создание слоя с нуля.
+Заметьте, что так как слой следующего шага зависит от слоя предыдущего, то изменения внесённые в промежуточный слой, также повлияют на последующие.
+
+Избегание копирования файлов не обязательно улучшит ситуацию, но использование кэша на одном шаге, позволит **использовать кэш и на следующих шагах**. Например, можно использовать кэш при установке зависимостей:
+
+```Dockerfile
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+```
+
+Файл со списком зависимостей **изменяется довольно редко**. Так что выполнив команду копирования только этого файла, Docker сможет **использовать кэш** на этом шаге.
+
+А затем **использовать кэш и на следующем шаге**, загружающем и устанавливающем зависимости.  И вот тут-то мы и **сэкономим много времени**. ✨ ...а не будем томиться в тягостном ожидании. 😪😆
+
+Для загрузки и установки необходимых библиотек **может понадобиться несколько минут**, но использование **кэша** занимает несколько **секунд** максимум.
+
+И так как во время разработки Вы будете часто пересобирать контейнер для проверки работоспособности внесённых изменений, то сэкономленные минуты сложатся в часы, а то и дни.
+
+Так как папка с кодом приложения **изменяется чаще всего**, то мы расположили её в конце `Dockerfile`, ведь после внесённых в код изменений кэш не будет использован на этом и следующих шагах.
+
+```Dockerfile
+COPY ./app /code/app
+```
+
+### Создать Docker-образ
+
+Теперь, когда все файлы на своих местах, давайте создадим образ контейнера.
+
+* Перейдите в директорию проекта (в ту, где расположены `Dockerfile` и папка `app` с приложением).
+* Создай образ приложения FastAPI:
+
+<div class="termy">
+
+```console
+$ docker build -t myimage .
+
+---> 100%
+```
+
+</div>
+
+!!! tip "Подсказка"
+    Обратите внимание, что в конце написана точка -  `.`, это то же самое что и `./`, тем самым мы указываем Docker директорию, из которой нужно выполнять сборку образа контейнера.
+
+    В данном случае это та же самая директория (`.`).
+
+### Запуск Docker-контейнера
+
+* Запустите контейнер, основанный на Вашем образе:
+
+<div class="termy">
+
+```console
+$ docker run -d --name mycontainer -p 80:80 myimage
+```
+
+</div>
+
+## Проверка
+
+Вы можете проверить, что Ваш Docker-контейнер работает перейдя по ссылке: <a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> или <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (или похожей, которую использует Ваш Docker-хост).
+
+Там Вы увидите:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+## Интерактивная документация API
+
+Теперь перейдите по ссылке <a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> или <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (или похожей, которую использует Ваш Docker-хост).
+
+Здесь Вы увидите автоматическую интерактивную документацию API (предоставляемую <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+## Альтернативная документация API
+
+Также Вы можете перейти по ссылке <a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> or <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (или похожей, которую использует Ваш Docker-хост).
+
+Здесь Вы увидите альтернативную автоматическую документацию API (предоставляемую <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Создание Docker-образа на основе однофайлового приложения FastAPI
+
+Если Ваше приложение FastAPI помещено в один файл, например, `main.py` и структура Ваших файлов похожа на эту:
+
+```
+.
+├── Dockerfile
+├── main.py
+└── requirements.txt
+```
+
+Вам нужно изменить в `Dockerfile` соответствующие пути копирования файлов:
+
+```{ .dockerfile .annotate hl_lines="10  13" }
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (1)
+COPY ./main.py /code/
+
+# (2)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. Скопируйте непосредственно файл `main.py` в директорию `/code` (не указывайте `./app`).
+
+2. При запуске Uvicorn укажите ему, что объект `app` нужно импортировать из файла `main` (вместо импортирования из `app.main`).
+
+Настройте Uvicorn на использование `main` вместо `app.main` для импорта объекта `app`.
+
+## Концепции развёртывания
+
+Давайте вспомним о [Концепциях развёртывания](./concepts.md){.internal-link target=_blank} и применим их к контейнерам.
+
+Контейнеры - это, в основном, инструмент упрощающий **сборку и развёртывание** приложения и они не обязыают к применению какой-то определённой **концепции развёртывания**, а значит мы можем выбирать нужную стратегию.
+
+**Хорошая новость** в том, что независимо от выбранной стратегии, мы всё равно можем покрыть все концепции развёртывания. 🎉
+
+Рассмотрим эти **концепции развёртывания** применительно к контейнерам:
+
+* Использование более безопасного протокола HTTPS
+* Настройки запуска приложения
+* Перезагрузка приложения
+* Запуск нескольких экземпляров приложения
+* Управление памятью
+* Использование перечисленных функций перед запуском приложения
+
+## Использование более безопасного протокола HTTPS
+
+Если мы определимся, что **образ контейнера** будет содержать только приложение FastAPI, то работу с HTTPS можно организовать **снаружи** контейнера при помощи другого инструмента.
+
+Это может быть другой контейнер, в котором есть, например, <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>, работающий с **HTTPS** и **самостоятельно** обновляющий **сертификаты**.
+
+!!! tip "Подсказка"
+    Traefik совместим с Docker, Kubernetes и им подобными инструментами. Он очень прост в установке и настройке использования HTTPS для Ваших контейнеров.
+
+В качестве альтернативы, работу с HTTPS можно доверить облачному провайдеру, если он предоставляет такую услугу.
+
+## Настройки запуска и перезагрузки приложения
+
+Обычно **запуском контейнера с приложением** занимается какой-то отдельный инструмент.
+
+Это может быть сам **Docker**, **Docker Compose**, **Kubernetes**, **облачный провайдер** и т.п.
+
+В большинстве случаев это простейшие настройки запуска и перезагрузки приложения (при падении). Например, команде запуска Docker-контейнера можно добавить опцию `--restart`.
+
+Управление запуском и перезагрузкой приложений без использования контейнеров - весьма затруднительно. Но при **работе с контейнерами** - это всего лишь функционал доступный по умолчанию. ✨
+
+## Запуск нескольких экземпляров приложения - Указание количества процессов
+
+Если у Вас есть <abbr title="Несколько серверов настроенных для совместной работы.">кластер</abbr> машин под управлением **Kubernetes**, Docker Swarm Mode, Nomad или аналогичной сложной системой оркестрации контейнеров, скорее всего, вместо использования менеджера процессов (типа Gunicorn и его воркеры) в каждом контейнере, Вы захотите **управлять количеством запущенных экземпляров приложения** на **уровне кластера**.
+
+В любую из этих систем управления контейнерами обычно встроен способ управления **количеством запущенных контейнеров** для распределения **нагрузки** от входящих запросов на **уровне кластера**.
+
+В такой ситуации Вы, вероятно, захотите создать **образ Docker**, как [описано выше](#dockerfile), с установленными зависимостями и запускающий **один процесс Uvicorn** вместо того, чтобы запускать Gunicorn управляющий несколькими воркерами Uvicorn.
+
+### Балансировщик нагрузки
+
+Обычно при использовании контейнеров один компонент **прослушивает главный порт**. Это может быть контейнер содержащий **прокси-сервер завершения работы TLS** для работы с **HTTPS** или что-то подобное.
+
+Поскольку этот компонент **принимает запросы** и равномерно **распределяет** их между компонентами, его также называют **балансировщиком нагрузки**.
+
+!!! tip "Подсказка"
+    **Прокси-сервер завершения работы TLS** одновременно может быть **балансировщиком нагрузки**.
+
+Система оркестрации, которую Вы используете для запуска и управления контейнерами, имеет встроенный инструмент **сетевого взаимодействия** (например, для передачи HTTP-запросов) между контейнерами с Вашими приложениями и **балансировщиком нагрузки** (который также может быть **прокси-сервером**).
+
+### Один балансировщик - Множество контейнеров
+
+При работе с **Kubernetes** или аналогичными системами оркестрации использование их внутреннней сети позволяет иметь один **балансировщик нагрузки**, который прослушивает **главный** порт и передаёт запросы **множеству запущенных контейнеров** с Вашими приложениями.
+
+В каждом из контейнеров обычно работает **только один процесс** (например, процесс Uvicorn управляющий Вашим приложением FastAPI). Контейнеры могут быть **идентичными**, запущенными на основе одного и того же образа, но у каждого будут свои отдельные процесс, память и т.п. Таким образом мы получаем преимущества **распараллеливания** работы по **разным ядрам** процессора или даже **разным машинам**.
+
+Система управления контейнерами с **балансировщиком нагрузки** будет **распределять запросы** к контейнерам с приложениями **по очереди**. То есть каждый запрос будет обработан одним из множества **одинаковых контейнеров** с одним и тем же приложением.
+
+**Балансировщик нагрузки** может обрабатывать запросы к *разным* приложениям, расположенным в Вашем кластере (например, если у них разные домены или префиксы пути) и передавать запросы нужному контейнеру с требуемым приложением.
+
+### Один процесс на контейнер
+
+В этом варианте **в одном контейнере будет запущен только один процесс (Uvicorn)**, а управление изменением количества запущенных копий приложения происходит на уровне кластера.
+
+Здесь **не нужен** менеджер процессов типа Gunicorn, управляющий процессами Uvicorn, или же Uvicorn, управляющий другими процессами Uvicorn. Достаточно **только одного процесса Uvicorn** на контейнер (но запуск нескольких процессов не запрещён).
+
+Использование менеджера процессов (Gunicorn или Uvicorn) внутри контейнера только добавляет **излишнее усложнение**, так как управление следует осуществлять системой оркестрации.
+
+### <a name="special-cases"></a>Множество процессов внутри контейнера для особых случаев</a>
+
+Безусловно, бывают **особые случаи**, когда может понадобится внутри контейнера запускать **менеджер процессов Gunicorn**, управляющий несколькими **процессами Uvicorn**.
+
+Для таких случаев Вы можете использовать **официальный Docker-образ** (прим. пер: - *здесь и далее на этой странице, если Вы встретите сочетание "официальный Docker-образ" без уточнений, то автор имеет в виду именно предоставляемый им образ*), где в качестве менеджера процессов используется **Gunicorn**, запускающий несколько **процессов Uvicorn** и некоторые настройки по умолчанию, автоматически устанавливающие количество запущенных процессов в зависимости от количества ядер Вашего процессора. Я расскажу Вам об этом подробнее тут: [Официальный Docker-образ со встроенными Gunicorn и Uvicorn](#docker-gunicorn-uvicorn).
+
+Некоторые примеры подобных случаев:
+
+#### Простое приложение
+
+Вы можете использовать менеджер процессов внутри контейнера, если Ваше приложение **настолько простое**, что у Вас нет необходимости (по крайней мере, пока нет) в тщательных настройках количества процессов и Вам достаточно имеющихся настроек по умолчанию (если используется официальный Docker-образ) для запуска приложения **только на одном сервере**, а не в кластере.
+
+#### Docker Compose
+
+С помощью **Docker Compose** можно разворачивать несколько контейнеров на **одном сервере** (не кластере), но при это у Вас не будет простого способа управления количеством запущенных контейнеров с одновременным сохранением общей сети и **балансировки нагрузки**.
+
+В этом случае можно использовать **менеджер процессов**, управляющий **несколькими процессами**, внутри **одного контейнера**.
+
+#### Prometheus и прочие причины
+
+У Вас могут быть и **другие причины**, когда использование **множества процессов** внутри **одного контейнера** будет проще, нежели запуск **нескольких контейнеров** с **единственным процессом** в каждом из них.
+
+Например (в зависимости от конфигурации), у Вас могут быть инструменты подобные экспортёру Prometheus, которые должны иметь доступ к **каждому запросу** приходящему в контейнер.
+
+Если у Вас будет **несколько контейнеров**, то Prometheus, по умолчанию,  **при сборе метрик** получит их **только с одного контейнера**, который обрабатывает конкретный запрос, вместо **сбора метрик** со всех работающих контейнеров.
+
+В таком случае может быть проще иметь **один контейнер** со **множеством процессов**, с нужным инструментом (таким как экспортёр Prometheus) в этом же контейнере и собирающем метрики со всех внутренних процессов этого контейнера.
+
+---
+
+Самое главное - **ни одно** из перечисленных правил не является **высеченным в камне** и Вы не обязаны слепо их повторять. Вы можете использовать эти идеи при **рассмотрении Вашего конкретного случая** и самостоятельно решать, какая из концепции подходит лучше:
+
+* Использование более безопасного протокола HTTPS
+* Настройки запуска приложения
+* Перезагрузка приложения
+* Запуск нескольких экземпляров приложения
+* Управление памятью
+* Использование перечисленных функций перед запуском приложения
+
+## Управление памятью
+
+При **запуске одного процесса на контейнер** Вы получаете относительно понятный, стабильный и ограниченный объём памяти, потребляемый одним контейнером.
+
+Вы можете установить аналогичные ограничения по памяти при конфигурировании своей системы управления контейнерами (например, **Kubernetes**). Таким образом система сможет **изменять количество контейнеров** на **доступных ей машинах** приводя в соответствие количество памяти нужной контейнерам с количеством памяти доступной в кластере (наборе доступных машин).
+
+Если у Вас **простенькое** приложение, вероятно у Вас не будет **необходимости** устанавливать жёсткие ограничения на выделяемую ему память. Но если приложение **использует много памяти** (например, оно использует модели **машинного обучения**), Вам следует проверить, как много памяти ему требуется и отрегулировать **количество контейнеров** запущенных на **каждой машине** (может быть даже добавить машин в кластер).
+
+Если Вы запускаете **несколько процессов в контейнере**, то должны быть уверены, что эти процессы не **займут памяти больше**, чем доступно для контейнера.
+
+## Подготовительные шаги при запуске контейнеров
+
+Есть два основных подхода, которые Вы можете использовать при запуске контейнеров (Docker, Kubernetes и т.п.).
+
+### Множество контейнеров
+
+Когда Вы запускаете **множество контейнеров**, в каждом из которых работает **только один процесс** (например, в кластере **Kubernetes**), может возникнуть необходимость иметь **отдельный контейнер**, который осуществит **предварительные шаги перед запуском** остальных контейнеров (например, применяет миграции к базе данных).
+
+!!! info "Информация"
+    При использовании Kubernetes, это может быть <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Инициализирующий контейнер</a>.
+
+При отсутствии такой необходимости (допустим, не нужно применять миграции к базе данных, а только проверить, что она готова принимать соединения), Вы можете проводить такую проверку в каждом контейнере перед запуском его основного процесса и запускать все контейнеры **одновременно**.
+
+### Только один контейнер
+
+Если у Вас несложное приложение для работы которого достаточно **одного контейнера**, но в котором работает **несколько процессов** (или один процесс), то прохождение предварительных шагов можно осуществить в этом же контейнере до запуска основного процесса. Официальный Docker-образ поддерживает такие действия.
+
+## Официальный Docker-образ с Gunicorn и Uvicorn
+
+Я подготовил для Вас Docker-образ, в который включён Gunicorn управляющий процессами (воркерами) Uvicorn, в соответствии с концепциями рассмотренными в предыдущей главе: [Рабочие процессы сервера (воркеры) - Gunicorn совместно с Uvicorn](./server-workers.md){.internal-link target=_blank}.
+
+Этот образ может быть полезен для ситуаций описанных тут: [Множество процессов внутри контейнера для особых случаев](#special-cases).
+
+* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+
+!!! warning "Предупреждение"
+    Скорее всего у Вас **нет необходимости** в использовании этого образа или подобного ему и лучше создать свой образ с нуля как описано тут: [Создать Docker-образ для FastAPI](#docker-fastapi).
+
+В этом образе есть **автоматический** механизм подстройки для запуска **необходимого количества процессов** в соответствии с доступным количеством ядер процессора.
+
+В нём установлены **разумные значения по умолчанию**, но можно изменять и обновлять конфигурацию с помощью **переменных окружения** или конфигурационных файлов.
+
+Он также поддерживает прохождение <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**Подготовительных шагов при запуске контейнеров**</a> при помощи скрипта.
+
+!!! tip "Подсказка"
+    Для просмотра всех возможных настроек перейдите на страницу этого Docker-образа: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+
+### Количество процессов в официальном Docker-образе
+
+**Количество процессов** в этом образе **вычисляется автоматически** и зависит от доступного количества **ядер** центрального процессора.
+
+Это означает, что он будет пытаться **выжать** из процессора как можно больше **производительности**.
+
+Но Вы можете изменять и обновлять конфигурацию с помощью **переменных окружения** и т.п.
+
+Поскольку количество процессов зависит от процессора, на котором работает контейнер, **объём потребляемой памяти** также будет зависеть от этого.
+
+А значит, если Вашему приложению требуется много оперативной памяти (например, оно использует модели машинного обучения) и Ваш сервер имеет центральный процессор с большим количеством ядер, но **не слишком большим объёмом оперативной памяти**, то может дойти до того, что контейнер попытается занять памяти больше, чем доступно, из-за чего будет падение производительности (или сервер вовсе упадёт). 🚨
+
+
+### Написание  `Dockerfile`
+
+Итак, теперь мы можем написать  `Dockerfile` основанный на этом официальном Docker-образе:
+
+```Dockerfile
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app
+```
+
+### Большие приложения
+
+Если Вы успели ознакомиться с разделом [Приложения содержащие много файлов](../tutorial/bigger-applications.md){.internal-link target=_blank}, состоящие из множества файлов, Ваш Dockerfile может выглядеть так:
+
+```Dockerfile hl_lines="7"
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app/app
+```
+
+### Как им пользоваться
+
+Если Вы используете **Kubernetes** (или что-то вроде того), скорее всего Вам **не нужно** использовать официальный Docker-образ (или другой похожий) в качестве основы, так как управление **количеством запущенных контейнеров** должно быть настроено на уровне кластера. В таком случае лучше **создать образ с нуля**, как описано в разделе Создать [Docker-образ для FastAPI](#docker-fastapi).
+
+Официальный образ может быть полезен в отдельных случаях, описанных выше в разделе [Множество процессов внутри контейнера для особых случаев](#special-cases). Например, если Ваше приложение **достаточно простое**, не требует запуска в кластере и способно уместиться в один контейнер, то его настройки по умолчанию будут работать довольно хорошо. Или же Вы развертываете его с помощью **Docker Compose**, работаете на одном сервере и т. д
+
+## Развёртывание образа контейнера
+
+После создания образа контейнера существует несколько способов его развёртывания.
+
+Например:
+
+* С использованием **Docker Compose** при развёртывании на одном сервере
+* С использованием **Kubernetes** в кластере
+* С использованием режима Docker Swarm в кластере
+* С использованием других инструментов, таких как Nomad
+* С использованием облачного сервиса, который будет управлять разворачиванием Вашего контейнера
+
+## Docker-образ и Poetry
+
+Если Вы пользуетесь <a href="https://python-poetry.org/" class="external-link" target="_blank">Poetry</a> для управления зависимостями Вашего проекта, то можете использовать многоэтапную сборку образа:
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9 as requirements-stage
+
+# (2)
+WORKDIR /tmp
+
+# (3)
+RUN pip install poetry
+
+# (4)
+COPY ./pyproject.toml ./poetry.lock* /tmp/
+
+# (5)
+RUN poetry export -f requirements.txt --output requirements.txt --without-hashes
+
+# (6)
+FROM python:3.9
+
+# (7)
+WORKDIR /code
+
+# (8)
+COPY --from=requirements-stage /tmp/requirements.txt /code/requirements.txt
+
+# (9)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (10)
+COPY ./app /code/app
+
+# (11)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. Это первый этап, которому мы дадим имя `requirements-stage`.
+
+2. Установите директорию `/tmp` в качестве рабочей директории.
+
+    В ней будет создан файл `requirements.txt`
+
+3. На этом шаге установите Poetry.
+
+4. Скопируйте файлы `pyproject.toml` и `poetry.lock` в директорию `/tmp`.
+
+    Поскольку название файла написано как `./poetry.lock*` (с `*` в конце), то ничего не сломается, если такой файл не будет найден.
+
+5. Создайте файл `requirements.txt`.
+
+6. Это второй (и последний) этап сборки, который и создаст окончательный образ контейнера.
+
+7. Установите директорию `/code` в качестве рабочей.
+
+8. Скопируйте файл `requirements.txt` в директорию `/code`.
+
+    Этот файл находится в образе, созданном на предыдущем этапе, которому мы дали имя requirements-stage, потому при копировании нужно написать `--from-requirements-stage`.
+
+9.  Установите зависимости, указанные в файле `requirements.txt`.
+
+10. Скопируйте папку `app` в папку `/code`.
+
+11. Запустите `uvicorn`, указав ему использовать объект `app`, расположенный в `app.main`.
+
+!!! tip "Подсказка"
+    Если ткнёте на кружок с плюсом, то увидите объяснения, что происходит в этой строке.
+
+**Этапы сборки Docker-образа** являются частью `Dockerfile` и работают как **временные образы контейнеров**. Они нужны только для создания файлов, используемых в дальнейших этапах.
+
+Первый этап был нужен только для **установки Poetry** и **создания файла `requirements.txt`**, в которым прописаны зависимости Вашего проекта, взятые из файла `pyproject.toml`.
+
+На **следующем этапе** `pip` будет использовать файл `requirements.txt`.
+
+В итоговом образе будет содержаться **только последний этап сборки**, предыдущие этапы будут отброшены.
+
+При использовании Poetry, имеет смысл использовать **многоэтапную сборку Docker-образа**, потому что на самом деле Вам не нужен Poetry и его зависимости в окончательном образе контейнера, Вам **нужен только** сгенерированный файл `requirements.txt` для установки зависимостей Вашего проекта.
+
+А на последнем этапе, придерживаясь описанных ранее правил, создаётся итоговый образ
+
+### Использование прокси-сервера завершения TLS и Poetry
+
+И снова повторюсь, если используете прокси-сервер (балансировщик нагрузки), такой, как Nginx или Traefik, добавьте в команду запуска опцию `--proxy-headers`:
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+## Резюме
+
+При помощи систем контейнеризации (таких, как **Docker** и **Kubernetes**), становится довольно просто обрабатывать все **концепции развертывания**:
+
+* Использование более безопасного протокола HTTPS
+* Настройки запуска приложения
+* Перезагрузка приложения
+* Запуск нескольких экземпляров приложения
+* Управление памятью
+* Использование перечисленных функций перед запуском приложения
+
+В большинстве случаев Вам, вероятно, не нужно использовать какой-либо базовый образ, **лучше создать образ контейнера с нуля** на основе официального Docker-образа Python.
+
+Позаботившись о **порядке написания** инструкций в `Dockerfile`, Вы сможете использовать **кэш Docker'а**, **минимизировав время сборки**, максимально повысив свою производительность (и избежать скуки). 😎
+
+В некоторых особых случаях вы можете использовать официальный образ Docker для FastAPI. 🤓
diff --git a/docs/ru/docs/external-links.md b/docs/ru/docs/external-links.md
index 4daf65898..2448ef82e 100644
--- a/docs/ru/docs/external-links.md
+++ b/docs/ru/docs/external-links.md
@@ -9,70 +9,21 @@
 !!! tip
     Если у вас есть статья, проект, инструмент или что-либо, связанное с **FastAPI**, что еще не перечислено здесь, создайте <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request</a>.
 
-## Статьи
+{% for section_name, section_content in external_links.items() %}
 
-### На английском
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
+
+### {{ 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>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### На японском
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### На вьетнамском
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### На русском
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### На немецком
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Подкасты
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Talks
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
 
 ## Проекты
 
diff --git a/docs/ru/docs/features.md b/docs/ru/docs/features.md
index e18f7bc87..97841cc83 100644
--- a/docs/ru/docs/features.md
+++ b/docs/ru/docs/features.md
@@ -27,7 +27,7 @@
 
 ### Только современный Python
 
-Все эти возможности основаны на стандартных **аннотациях типов Python 3.6** (благодаря Pydantic). Не нужно изучать новый синтаксис. Только лишь стандартный современный Python.
+Все эти возможности основаны на стандартных **аннотациях типов Python 3.8** (благодаря Pydantic). Не нужно изучать новый синтаксис. Только лишь стандартный современный Python.
 
 Если вам нужно освежить знания, как использовать аннотации типов в Python (даже если вы не используете FastAPI), выделите 2 минуты и просмотрите краткое руководство: [Введение в аннотации типов Python¶
 ](python-types.md){.internal-link target=_blank}.
diff --git a/docs/ru/docs/help-fastapi.md b/docs/ru/docs/help-fastapi.md
index a69e37bd8..65ff768d1 100644
--- a/docs/ru/docs/help-fastapi.md
+++ b/docs/ru/docs/help-fastapi.md
@@ -223,8 +223,6 @@
 
     Используйте этот чат только для бесед на отвлечённые темы.
 
-Существует также <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">чат в Gitter</a>, но поскольку в нем нет каналов и расширенных функций, общение в нём сложнее, потому рекомендуемой системой является Discord.
-
 ### Не использовать чаты для вопросов
 
 Имейте в виду, что чаты позволяют больше "свободного общения", потому там легко задавать вопросы, которые слишком общие и на которые труднее ответить, так что Вы можете не получить нужные Вам ответы.
diff --git a/docs/ru/docs/index.md b/docs/ru/docs/index.md
index 30c32e046..97a3947bd 100644
--- a/docs/ru/docs/index.md
+++ b/docs/ru/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI — это современный, быстрый (высокопроизводительный) веб-фреймворк для создания API используя Python 3.6+, в основе которого лежит стандартная аннотация типов Python.
+FastAPI — это современный, быстрый (высокопроизводительный) веб-фреймворк для создания API используя Python 3.8+, в основе которого лежит стандартная аннотация типов Python.
 
 Ключевые особенности:
 
@@ -109,7 +109,7 @@ FastAPI — это современный, быстрый (высокопрои
 
 ## Зависимости
 
-Python 3.7+
+Python 3.8+
 
 FastAPI стоит на плечах гигантов:
 
@@ -325,7 +325,7 @@ def update_item(item_id: int, item: Item):
 
 Вам не нужно изучать новый синтаксис, методы или классы конкретной библиотеки и т. д.
 
-Только стандартный **Python 3.6+**.
+Только стандартный **Python 3.8+**.
 
 Например, для `int`:
 
diff --git a/docs/ru/docs/tutorial/background-tasks.md b/docs/ru/docs/tutorial/background-tasks.md
index 81efda786..7a3cf6d83 100644
--- a/docs/ru/docs/tutorial/background-tasks.md
+++ b/docs/ru/docs/tutorial/background-tasks.md
@@ -63,7 +63,7 @@
     {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="13  15  22  25"
     {!> ../../../docs_src/background_tasks/tutorial002.py!}
diff --git a/docs/ru/docs/tutorial/body-fields.md b/docs/ru/docs/tutorial/body-fields.md
index 674b8bde4..02a598004 100644
--- a/docs/ru/docs/tutorial/body-fields.md
+++ b/docs/ru/docs/tutorial/body-fields.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body_fields/tutorial001.py!}
@@ -31,13 +31,13 @@
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11-14"
     {!> ../../../docs_src/body_fields/tutorial001.py!}
     ```
 
-Функция `Field` работает так же, как `Query`, `Path` и `Body`, у ее такие же параметры и т.д.
+Функция `Field` работает так же, как `Query`, `Path` и `Body`, у неё такие же параметры и т.д.
 
 !!! note "Технические детали"
     На самом деле, `Query`, `Path` и другие функции, которые вы увидите в дальнейшем, создают объекты подклассов общего класса `Param`, который сам по себе является подклассом `FieldInfo` из Pydantic.
diff --git a/docs/ru/docs/tutorial/body-multiple-params.md b/docs/ru/docs/tutorial/body-multiple-params.md
index a20457092..e52ef6f6f 100644
--- a/docs/ru/docs/tutorial/body-multiple-params.md
+++ b/docs/ru/docs/tutorial/body-multiple-params.md
@@ -20,7 +20,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
@@ -35,7 +35,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать версию с `Annotated`, если это возможно.
@@ -68,7 +68,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -123,7 +123,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
@@ -138,7 +138,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -197,7 +197,7 @@ q: str | None = None
     {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="28"
     {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
@@ -212,7 +212,7 @@ q: str | None = None
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -250,7 +250,7 @@ item: Item = Body(embed=True)
     {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
@@ -265,7 +265,7 @@ item: Item = Body(embed=True)
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать `Annotated` версию, если это возможно.
diff --git a/docs/ru/docs/tutorial/body-nested-models.md b/docs/ru/docs/tutorial/body-nested-models.md
index 6435e316f..a6d123d30 100644
--- a/docs/ru/docs/tutorial/body-nested-models.md
+++ b/docs/ru/docs/tutorial/body-nested-models.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial001.py!}
@@ -73,7 +73,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial002.py!}
@@ -99,7 +99,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14"
     {!> ../../../docs_src/body_nested_models/tutorial003.py!}
@@ -137,7 +137,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -159,7 +159,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -208,7 +208,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10"
     {!> ../../../docs_src/body_nested_models/tutorial005.py!}
@@ -232,7 +232,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial006.py!}
@@ -283,7 +283,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14  20  23  27"
     {!> ../../../docs_src/body_nested_models/tutorial007.py!}
@@ -314,7 +314,7 @@ images: list[Image]
     {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/body_nested_models/tutorial008.py!}
@@ -354,7 +354,7 @@ images: list[Image]
     {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/body_nested_models/tutorial009.py!}
diff --git a/docs/ru/docs/tutorial/cookie-params.md b/docs/ru/docs/tutorial/cookie-params.md
index a6f2caa26..5f99458b6 100644
--- a/docs/ru/docs/tutorial/cookie-params.md
+++ b/docs/ru/docs/tutorial/cookie-params.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/cookie_params/tutorial001.py!}
@@ -30,7 +30,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/cookie_params/tutorial001.py!}
diff --git a/docs/ru/docs/tutorial/dependencies/global-dependencies.md b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
new file mode 100644
index 000000000..eb1b4d7c1
--- /dev/null
+++ b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
@@ -0,0 +1,34 @@
+# Глобальные зависимости
+
+Для некоторых типов приложений может потребоваться добавить зависимости ко всему приложению.
+
+Подобно тому, как вы можете [добавлять зависимости через параметр `dependencies` в *декораторах операций пути*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, вы можете добавлять зависимости сразу ко всему `FastAPI` приложению.
+
+В этом случае они будут применяться ко всем *операциям пути* в приложении:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/dependencies/tutorial012_an.py!}
+    ```
+
+=== "Python 3.8 non-Annotated"
+
+    !!! tip "Подсказка"
+        Рекомендуется использовать 'Annotated' версию, если это возможно.
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/dependencies/tutorial012.py!}
+    ```
+
+Все способы [добавления зависимостей в *декораторах операций пути*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank} по-прежнему применимы, но в данном случае зависимости применяются ко всем *операциям пути* приложения.
+
+## Зависимости для групп *операций пути*
+
+Позднее, читая о том, как структурировать более крупные [приложения, содержащие много файлов](../../tutorial/bigger-applications.md){.internal-link target=_blank}, вы узнаете, как объявить один параметр dependencies для целой группы *операций пути*.
diff --git a/docs/ru/docs/tutorial/extra-data-types.md b/docs/ru/docs/tutorial/extra-data-types.md
index efcbcb38a..0f613a6b2 100644
--- a/docs/ru/docs/tutorial/extra-data-types.md
+++ b/docs/ru/docs/tutorial/extra-data-types.md
@@ -55,7 +55,7 @@
 
 Вот пример *операции пути* с параметрами, который демонстрирует некоторые из вышеперечисленных типов.
 
-=== "Python 3.6 и выше"
+=== "Python 3.8 и выше"
 
     ```Python hl_lines="1  3  12-16"
     {!> ../../../docs_src/extra_data_types/tutorial001.py!}
@@ -69,7 +69,7 @@
 
 Обратите внимание, что параметры внутри функции имеют свой естественный тип данных, и вы, например, можете выполнять обычные манипуляции с датами, такие как:
 
-=== "Python 3.6 и выше"
+=== "Python 3.8 и выше"
 
     ```Python hl_lines="18-19"
     {!> ../../../docs_src/extra_data_types/tutorial001.py!}
diff --git a/docs/ru/docs/tutorial/extra-models.md b/docs/ru/docs/tutorial/extra-models.md
index a346f7432..30176b4e3 100644
--- a/docs/ru/docs/tutorial/extra-models.md
+++ b/docs/ru/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@
     {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -164,7 +164,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -187,7 +187,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -219,7 +219,7 @@ some_variable: PlaneItem | CarItem
     {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -239,7 +239,7 @@ some_variable: PlaneItem | CarItem
     {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/ru/docs/tutorial/header-params.md b/docs/ru/docs/tutorial/header-params.md
new file mode 100644
index 000000000..1be4ac707
--- /dev/null
+++ b/docs/ru/docs/tutorial/header-params.md
@@ -0,0 +1,227 @@
+# Header-параметры
+
+Вы можете определить параметры заголовка таким же образом, как вы определяете параметры `Query`, `Path` и `Cookie`.
+
+## Импорт `Header`
+
+Сперва импортируйте `Header`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
+
+## Объявление параметров `Header`
+
+Затем объявите параметры заголовка, используя ту же структуру, что и с `Path`, `Query` и `Cookie`.
+
+Первое значение является значением по умолчанию, вы можете передать все дополнительные параметры валидации или аннотации:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
+
+!!! note "Технические детали"
+    `Header` - это "родственный" класс `Path`, `Query` и `Cookie`. Он также наследуется от того же общего класса `Param`.
+
+    Но помните, что когда вы импортируете `Query`, `Path`, `Header` и другие из `fastapi`, на самом деле это функции, которые возвращают специальные классы.
+
+!!! info "Дополнительная информация"
+    Чтобы объявить заголовки, важно использовать `Header`, иначе параметры интерпретируются как query-параметры.
+
+## Автоматическое преобразование
+
+`Header` обладает небольшой дополнительной функциональностью в дополнение к тому, что предоставляют `Path`, `Query` и `Cookie`.
+
+Большинство стандартных заголовков разделены символом "дефис", также известным как "минус" (`-`).
+
+Но переменная вроде `user-agent` недопустима в Python.
+
+По умолчанию `Header` преобразует символы имен параметров из символа подчеркивания (`_`) в дефис (`-`) для извлечения и документирования заголовков.
+
+Кроме того, HTTP-заголовки не чувствительны к регистру, поэтому вы можете объявить их в стандартном стиле Python (также известном как "snake_case").
+
+Таким образом вы можете использовать `user_agent`, как обычно, в коде Python, вместо того, чтобы вводить заглавные буквы как `User_Agent` или что-то подобное.
+
+Если по какой-либо причине вам необходимо отключить автоматическое преобразование подчеркиваний в дефисы, установите для параметра `convert_underscores` в `Header` значение `False`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11"
+    {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/header_params/tutorial002_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/header_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002.py!}
+    ```
+
+!!! warning "Внимание"
+    Прежде чем установить для `convert_underscores` значение `False`, имейте в виду, что некоторые HTTP-прокси и серверы запрещают использование заголовков с подчеркиванием.
+
+## Повторяющиеся заголовки
+
+Есть возможность получать несколько заголовков с одним и тем же именем, но разными значениями.
+
+Вы можете определить эти случаи, используя список в объявлении типа.
+
+Вы получите все значения из повторяющегося заголовка в виде `list` Python.
+
+Например, чтобы объявить заголовок `X-Token`, который может появляться более одного раза, вы можете написать:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.9+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.8+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003.py!}
+    ```
+
+Если вы взаимодействуете с этой *операцией пути*, отправляя два HTTP-заголовка, таких как:
+
+```
+X-Token: foo
+X-Token: bar
+```
+
+Ответ был бы таким:
+
+```JSON
+{
+    "X-Token values": [
+        "bar",
+        "foo"
+    ]
+}
+```
+
+## Резюме
+
+Объявляйте заголовки с помощью `Header`, используя тот же общий шаблон, как при `Query`, `Path` и `Cookie`.
+
+И не беспокойтесь о символах подчеркивания в ваших переменных, **FastAPI** позаботится об их преобразовании.
diff --git a/docs/ru/docs/tutorial/path-operation-configuration.md b/docs/ru/docs/tutorial/path-operation-configuration.md
index 013903add..db99409f4 100644
--- a/docs/ru/docs/tutorial/path-operation-configuration.md
+++ b/docs/ru/docs/tutorial/path-operation-configuration.md
@@ -25,7 +25,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  17"
     {!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
@@ -54,7 +54,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  27"
     {!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
@@ -92,7 +92,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20-21"
     {!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
@@ -116,7 +116,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-27"
     {!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
@@ -142,7 +142,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
diff --git a/docs/ru/docs/tutorial/path-params-numeric-validations.md b/docs/ru/docs/tutorial/path-params-numeric-validations.md
index 0d034ef34..bd2c29d0a 100644
--- a/docs/ru/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ru/docs/tutorial/path-params-numeric-validations.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3-4"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -67,7 +67,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -82,7 +82,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -117,7 +117,7 @@
 
 Поэтому вы можете определить функцию так:
 
-=== "Python 3.6 без Annotated"
+=== "Python 3.8 без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -134,7 +134,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
@@ -174,7 +174,7 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
@@ -192,13 +192,13 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -220,13 +220,13 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -251,13 +251,13 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
diff --git a/docs/ru/docs/tutorial/query-params-str-validations.md b/docs/ru/docs/tutorial/query-params-str-validations.md
index 68042db63..cc826b871 100644
--- a/docs/ru/docs/tutorial/query-params-str-validations.md
+++ b/docs/ru/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@
     {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
@@ -42,7 +42,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     В версиях Python ниже Python 3.9 `Annotation` импортируется из `typing_extensions`.
 
@@ -66,7 +66,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     q: str | None = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Union[str, None] = None
@@ -80,7 +80,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     q: Annotated[str | None] = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Annotated[Union[str, None]] = None
@@ -100,7 +100,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
@@ -131,7 +131,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     {!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
@@ -244,7 +244,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
@@ -259,7 +259,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -284,7 +284,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
@@ -299,7 +299,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -330,13 +330,13 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -384,13 +384,13 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -414,13 +414,13 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -454,7 +454,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
@@ -469,7 +469,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -491,13 +491,13 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  9"
     {!> ../../../docs_src/query_params_str_validations/tutorial006d_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -527,7 +527,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
@@ -551,7 +551,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -596,7 +596,7 @@ http://localhost:8000/items/?q=foo&q=bar
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
@@ -611,7 +611,7 @@ http://localhost:8000/items/?q=foo&q=bar
     {!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -647,13 +647,13 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -692,7 +692,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
@@ -707,7 +707,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -730,7 +730,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
@@ -741,11 +741,11 @@ http://localhost:8000/items/
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
 
-    ```Python hl_lines="12"
+    ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -784,7 +784,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
@@ -799,7 +799,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -828,7 +828,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
@@ -839,11 +839,11 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
 
-    ```Python hl_lines="17"
+    ```Python hl_lines="16"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -872,7 +872,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
@@ -887,7 +887,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
diff --git a/docs/ru/docs/tutorial/query-params.md b/docs/ru/docs/tutorial/query-params.md
index 68333ec56..6e885cb65 100644
--- a/docs/ru/docs/tutorial/query-params.md
+++ b/docs/ru/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ http://127.0.0.1:8000/items/?skip=20
     {!> ../../../docs_src/query_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial002.py!}
@@ -90,7 +90,7 @@ http://127.0.0.1:8000/items/?skip=20
     {!> ../../../docs_src/query_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial003.py!}
@@ -143,7 +143,7 @@ http://127.0.0.1:8000/items/foo?short=yes
     {!> ../../../docs_src/query_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  10"
     {!> ../../../docs_src/query_params/tutorial004.py!}
@@ -209,7 +209,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
     {!> ../../../docs_src/query_params/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params/tutorial006.py!}
diff --git a/docs/ru/docs/tutorial/request-forms.md b/docs/ru/docs/tutorial/request-forms.md
new file mode 100644
index 000000000..0fc9e4eda
--- /dev/null
+++ b/docs/ru/docs/tutorial/request-forms.md
@@ -0,0 +1,92 @@
+# Данные формы
+
+Когда вам нужно получить поля формы вместо JSON, вы можете использовать `Form`.
+
+!!! info "Дополнительная информация"
+    Чтобы использовать формы, сначала установите <a href="https://andrew-d.github.io/python-multipart/" class="external-link" target="_blank">`python-multipart`</a>.
+
+    Например, выполните команду `pip install python-multipart`.
+
+## Импорт `Form`
+
+Импортируйте `Form` из `fastapi`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/request_forms/tutorial001_an.py!}
+    ```
+
+=== "Python 3.8+ без Annotated"
+
+    !!! tip "Подсказка"
+        Рекомендуется использовать 'Annotated' версию, если это возможно.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/request_forms/tutorial001.py!}
+    ```
+
+## Определение параметров `Form`
+
+Создайте параметры формы так же, как это делается для `Body` или `Query`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/request_forms/tutorial001_an.py!}
+    ```
+
+=== "Python 3.8+ без Annotated"
+
+    !!! tip "Подсказка"
+        Рекомендуется использовать 'Annotated' версию, если это возможно.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/request_forms/tutorial001.py!}
+    ```
+
+Например, в одном из способов использования спецификации OAuth2 (называемом "потоком пароля") требуется отправить `username` и `password` в виде полей формы.
+
+Данный способ требует отправку данных для авторизации посредством формы (а не JSON) и обязательного наличия в форме строго именованных полей  `username` и `password`.
+
+Вы можете настроить `Form` точно так же, как настраиваете и  `Body` ( `Query`, `Path`, `Cookie`), включая валидации, примеры, псевдонимы (например, `user-name` вместо `username`) и т.д.
+
+!!! info "Дополнительная информация"
+    `Form` - это класс, который наследуется непосредственно от `Body`.
+
+!!! tip "Подсказка"
+   Вам необходимо явно указывать параметр `Form` при объявлении каждого поля, иначе поля будут интерпретироваться как параметры запроса или параметры тела (JSON).
+
+## О "полях формы"
+
+Обычно способ, которым HTML-формы (`<form></form>`) отправляют данные на сервер, использует "специальное" кодирование для этих данных, отличное от JSON.
+
+**FastAPI** гарантирует правильное чтение этих данных из соответствующего места, а не из JSON.
+
+!!! note "Технические детали"
+    Данные из форм обычно кодируются с использованием "типа медиа" `application/x-www-form-urlencoded`.
+
+    Но когда форма содержит файлы, она кодируется как `multipart/form-data`. Вы узнаете о работе с файлами в следующей главе.
+
+    Если вы хотите узнать больше про кодировки и поля формы, ознакомьтесь с <a href="https://developer.mozilla.org/ru/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank">документацией <abbr title="Mozilla Developer Network">MDN</abbr> для `POST` на веб-сайте</a>.
+
+!!! warning "Предупреждение"
+    Вы можете объявлять несколько параметров `Form` в *операции пути*, но вы не можете одновременно с этим объявлять поля `Body`, которые вы ожидаете получить в виде JSON, так как запрос будет иметь тело, закодированное с использованием `application/x-www-form-urlencoded`, а не `application/json`.
+
+    Это не ограничение **FastAPI**, это часть протокола HTTP.
+
+## Резюме
+
+Используйте `Form` для объявления входных параметров данных формы.
diff --git a/docs/ru/docs/tutorial/response-model.md b/docs/ru/docs/tutorial/response-model.md
index c5e111790..38b45e2a5 100644
--- a/docs/ru/docs/tutorial/response-model.md
+++ b/docs/ru/docs/tutorial/response-model.md
@@ -16,7 +16,7 @@ FastAPI позволяет использовать **аннотации тип
     {!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18  23"
     {!> ../../../docs_src/response_model/tutorial001_01.py!}
@@ -65,7 +65,7 @@ FastAPI будет использовать этот возвращаемый т
     {!> ../../../docs_src/response_model/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  24-27"
     {!> ../../../docs_src/response_model/tutorial001.py!}
@@ -101,7 +101,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -120,7 +120,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -145,7 +145,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -159,7 +159,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -173,7 +173,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -207,7 +207,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-13  15-16  20"
     {!> ../../../docs_src/response_model/tutorial003_01.py!}
@@ -283,7 +283,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/response_model/tutorial003_04.py!}
@@ -305,7 +305,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/response_model/tutorial003_05.py!}
@@ -329,7 +329,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11  13-14"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -359,7 +359,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -446,7 +446,7 @@ FastAPI достаточно умен (на самом деле, это засл
     {!> ../../../docs_src/response_model/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial005.py!}
@@ -467,7 +467,7 @@ FastAPI достаточно умен (на самом деле, это засл
     {!> ../../../docs_src/response_model/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial006.py!}
diff --git a/docs/ru/docs/tutorial/schema-extra-example.md b/docs/ru/docs/tutorial/schema-extra-example.md
index a0363b9ba..a13ab5935 100644
--- a/docs/ru/docs/tutorial/schema-extra-example.md
+++ b/docs/ru/docs/tutorial/schema-extra-example.md
@@ -14,7 +14,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-23"
     {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
@@ -39,7 +39,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10-13"
     {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
@@ -78,7 +78,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28"
     {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
@@ -93,7 +93,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip Заметка
         Рекомендуется использовать версию с `Annotated`, если это возможно.
@@ -133,7 +133,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24-50"
     {!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
@@ -148,7 +148,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip Заметка
         Рекомендуется использовать версию с `Annotated`, если это возможно.
diff --git a/docs/ru/docs/tutorial/security/index.md b/docs/ru/docs/tutorial/security/index.md
new file mode 100644
index 000000000..d5fe4e76f
--- /dev/null
+++ b/docs/ru/docs/tutorial/security/index.md
@@ -0,0 +1,101 @@
+# Настройка авторизации
+
+Существует множество способов обеспечения безопасности, аутентификации и авторизации.
+
+Обычно эта тема является достаточно сложной и трудной.
+
+Во многих фреймворках и системах только работа с определением доступов к приложению и аутентификацией требует значительных затрат усилий и написания множества кода (во многих случаях его объём может составлять более 50% от всего написанного кода).
+
+**FastAPI** предоставляет несколько инструментов, которые помогут вам настроить **Авторизацию** легко, быстро, стандартным способом, без необходимости изучать все её тонкости.
+
+Но сначала давайте рассмотрим некоторые небольшие концепции.
+
+## Куда-то торопишься?
+
+Если вам не нужна информация о каких-либо из следующих терминов и вам просто нужно добавить защиту с аутентификацией на основе логина и пароля *прямо сейчас*, переходите к следующим главам.
+
+## OAuth2
+
+OAuth2 - это протокол, который определяет несколько способов обработки аутентификации и авторизации.
+
+Он довольно обширен и охватывает несколько сложных вариантов использования.
+
+OAuth2 включает в себя способы аутентификации с использованием "третьей стороны".
+
+Это то, что используют под собой все кнопки "вход с помощью Facebook, Google, Twitter, GitHub" на страницах авторизации.
+
+### OAuth 1
+
+Ранее использовался протокол OAuth 1, который сильно отличается от OAuth2 и является более сложным, поскольку он включал прямые описания того, как шифровать сообщение.
+
+В настоящее время он не очень популярен и не используется.
+
+OAuth2 не указывает, как шифровать сообщение, он ожидает, что ваше приложение будет обслуживаться по протоколу HTTPS.
+
+!!! tip "Подсказка"
+    В разделе **Развертывание** вы увидите [как настроить протокол HTTPS бесплатно, используя Traefik и Let's Encrypt.](https://fastapi.tiangolo.com/ru/deployment/https/)
+
+
+## OpenID Connect
+
+OpenID Connect - это еще один протокол, основанный на **OAuth2**.
+
+Он просто расширяет OAuth2, уточняя некоторые вещи, не имеющие однозначного определения в OAuth2, в попытке сделать его более совместимым.
+
+Например, для входа в Google используется OpenID Connect (который под собой использует OAuth2).
+
+Но вход в Facebook не поддерживает OpenID Connect. У него есть собственная вариация OAuth2.
+
+### OpenID (не "OpenID Connect")
+
+Также ранее использовался стандарт "OpenID", который пытался решить ту же проблему, что и **OpenID Connect**, но не был основан на OAuth2.
+
+Таким образом, это была полноценная дополнительная система.
+
+В настоящее время не очень популярен и не используется.
+
+## OpenAPI
+
+OpenAPI (ранее известный как Swagger) - это открытая спецификация для создания API (в настоящее время является частью Linux Foundation).
+
+**FastAPI** основан на **OpenAPI**.
+
+Это то, что делает возможным наличие множества автоматических интерактивных интерфейсов документирования, сгенерированного кода и т.д.
+
+В OpenAPI есть способ использовать несколько "схем" безопасности.
+
+Таким образом, вы можете воспользоваться преимуществами Всех этих стандартных инструментов, включая интерактивные системы документирования.
+
+OpenAPI может использовать следующие схемы авторизации:
+
+* `apiKey`: уникальный идентификатор для приложения, который может быть получен из:
+    * Параметров запроса.
+    * Заголовка.
+    * Cookies.
+* `http`: стандартные системы аутентификации по протоколу HTTP, включая:
+    * `bearer`: заголовок `Authorization` со значением `Bearer {уникальный токен}`. Это унаследовано от OAuth2.
+    * Базовая аутентификация по протоколу HTTP.
+    * HTTP Digest и т.д.
+* `oauth2`: все способы обеспечения безопасности OAuth2 называемые "потоки" (англ. "flows").
+    * Некоторые из этих "потоков" подходят для реализации аутентификации через сторонний сервис использующий OAuth 2.0 (например, Google, Facebook, Twitter, GitHub и т.д.):
+        * `implicit`
+        * `clientCredentials`
+        * `authorizationCode`
+    * Но есть один конкретный "поток", который может быть идеально использован для обработки аутентификации непосредственно в том же приложении:
+        * `password`: в некоторых следующих главах будут рассмотрены примеры этого.
+* `openIdConnect`: способ определить, как автоматически обнаруживать данные аутентификации OAuth2.
+    * Это автоматическое обнаружение определено в спецификации OpenID Connect.
+
+
+!!! tip "Подсказка"
+    Интеграция сторонних сервисов для аутентификации/авторизации таких как Google, Facebook, Twitter, GitHub и т.д. осуществляется достаточно легко.
+
+    Самой сложной проблемой является создание такого провайдера аутентификации/авторизации, но **FastAPI** предоставляет вам инструменты, позволяющие легко это сделать, выполняя при этом всю тяжелую работу за вас.
+
+## Преимущества **FastAPI**
+
+Fast API предоставляет несколько инструментов для каждой из этих схем безопасности в модуле `fastapi.security`, которые упрощают использование этих механизмов безопасности.
+
+В следующих главах вы увидите, как обезопасить свой API, используя инструменты, предоставляемые **FastAPI**.
+
+И вы также увидите, как он автоматически интегрируется в систему интерактивной документации.
diff --git a/docs/ru/docs/tutorial/testing.md b/docs/ru/docs/tutorial/testing.md
index 3f9005112..ca47a6f51 100644
--- a/docs/ru/docs/tutorial/testing.md
+++ b/docs/ru/docs/tutorial/testing.md
@@ -122,7 +122,7 @@
     {!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/app_testing/app_b_an/main.py!}
@@ -137,7 +137,7 @@
     {!> ../../../docs_src/app_testing/app_b_py310/main.py!}
     ```
 
-=== "Python 3.6+  без Annotated"
+=== "Python 3.8+  без Annotated"
 
     !!! tip "Подсказка"
         По возможности используйте версию с `Annotated`.
diff --git a/docs/tr/docs/features.md b/docs/tr/docs/features.md
index f8220fb58..8b143ffe7 100644
--- a/docs/tr/docs/features.md
+++ b/docs/tr/docs/features.md
@@ -27,7 +27,7 @@ OpenAPI standartlarına dayalı olan bir framework olarak, geliştiricilerin bir
 
 ### Sadece modern Python
 
-Tamamiyle standartlar **Python 3.6**'nın type hintlerine dayanıyor (Pydantic'in sayesinde). Yeni bir syntax öğrenmene gerek yok. Sadece modern Python.
+Tamamiyle standartlar **Python 3.8**'nın type hintlerine dayanıyor (Pydantic'in sayesinde). Yeni bir syntax öğrenmene gerek yok. Sadece modern Python.
 
 
 Eğer Python type hintlerini bilmiyorsan veya bir hatırlatmaya ihtiyacın var ise(FastAPI kullanmasan bile) şu iki dakikalık küçük bilgilendirici içeriğe bir göz at: [Python Types](python-types.md){.internal-link target=_blank}.
diff --git a/docs/tr/docs/index.md b/docs/tr/docs/index.md
index e74efbc2f..e61f5b82c 100644
--- a/docs/tr/docs/index.md
+++ b/docs/tr/docs/index.md
@@ -24,7 +24,7 @@
 
 ---
 
-FastAPI, Python 3.6+'nın standart type hintlerine dayanan modern ve hızlı (yüksek performanslı) API'lar oluşturmak için kullanılabilecek web framework'ü.
+FastAPI, Python 3.8+'nın standart type hintlerine dayanan modern ve hızlı (yüksek performanslı) API'lar oluşturmak için kullanılabilecek web framework'ü.
 
 Ana özellikleri:
 
@@ -115,7 +115,7 @@ Eğer API yerine <abbr title="Command Line Interface">komut satırı uygulaması
 
 ## Gereksinimler
 
-Python 3.7+
+Python 3.8+
 
 FastAPI iki devin omuzları üstünde duruyor:
 
@@ -331,7 +331,7 @@ Type-hinting işlemini Python dilindeki standart veri tipleri ile yapabilirsin
 
 Yeni bir syntax'e alışmana gerek yok, metodlar ve classlar zaten spesifik kütüphanelere ait.
 
-Sadece standart **Python 3.6+**.
+Sadece standart **Python 3.8+**.
 
 Örnek olarak, `int` tanımlamak için:
 
diff --git a/docs/uk/docs/alternatives.md b/docs/uk/docs/alternatives.md
new file mode 100644
index 000000000..e71257976
--- /dev/null
+++ b/docs/uk/docs/alternatives.md
@@ -0,0 +1,412 @@
+# Альтернативи, натхнення та порівняння
+
+Що надихнуло на створення **FastAPI**, який він у порінянні з іншими альтернативами та чого він у них навчився.
+
+## Вступ
+
+**FastAPI** не існувало б, якби не попередні роботи інших.
+
+Раніше було створено багато інструментів, які надихнули на його створення.
+
+Я кілька років уникав створення нового фреймворку. Спочатку я спробував вирішити всі функції, охоплені **FastAPI**, використовуючи багато різних фреймворків, плагінів та інструментів.
+
+Але в якийсь момент не було іншого виходу, окрім створення чогось, що надавало б усі ці функції, взявши найкращі ідеї з попередніх інструментів і поєднавши їх найкращим чином, використовуючи мовні функції, які навіть не були доступні раніше (Python 3.6+ підказки типів).
+
+## Попередні інструменти
+
+### <a href="https://www.djangoproject.com/" class="external-link" target="_blank">Django</a>
+
+Це найпопулярніший фреймворк Python, який користується широкою довірою. Він використовується для створення таких систем, як Instagram.
+
+Він відносно тісно пов’язаний з реляційними базами даних (наприклад, MySQL або PostgreSQL), тому мати базу даних NoSQL (наприклад, Couchbase, MongoDB, Cassandra тощо) як основний механізм зберігання не дуже просто.
+
+Він був створений для створення HTML у серверній частині, а не для створення API, які використовуються сучасним інтерфейсом (як-от React, Vue.js і Angular) або іншими системами (як-от <abbr title="Internet of Things">IoT</abbr > пристрої), які спілкуються з ним.
+
+### <a href="https://www.django-rest-framework.org/" class="external-link" target="_blank">Django REST Framework</a>
+
+Фреймворк Django REST був створений як гнучкий інструментарій для створення веб-інтерфейсів API використовуючи Django в основі, щоб покращити його можливості API.
+
+Його використовують багато компаній, включаючи Mozilla, Red Hat і Eventbrite.
+
+Це був один із перших прикладів **автоматичної документації API**, і саме це була одна з перших ідей, яка надихнула на «пошук» **FastAPI**.
+
+!!! Примітка
+     Django REST Framework створив Том Крісті. Той самий творець Starlette і Uvicorn, на яких базується **FastAPI**.
+
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Мати автоматичний веб-інтерфейс документації API.
+
+### <a href="https://flask.palletsprojects.com" class="external-link" target="_blank">Flask</a>
+
+Flask — це «мікрофреймворк», він не включає інтеграцію бази даних, а також багато речей, які за замовчуванням є в Django.
+
+Ця простота та гнучкість дозволяють використовувати бази даних NoSQL як основну систему зберігання даних.
+
+Оскільки він дуже простий, він порівняно легкий та інтуїтивний для освоєння, хоча в деяких моментах документація стає дещо технічною.
+
+Він також зазвичай використовується для інших програм, яким не обов’язково потрібна база даних, керування користувачами або будь-яка з багатьох функцій, які є попередньо вбудованими в Django. Хоча багато з цих функцій можна додати за допомогою плагінів.
+
+Відокремлення частин було ключовою особливістю, яку я хотів зберегти, при цьому залишаючись «мікрофреймворком», який можна розширити, щоб охопити саме те, що потрібно.
+
+Враховуючи простоту Flask, він здавався хорошим підходом для створення API. Наступним, що знайшов, був «Django REST Framework» для Flask.
+
+!!! Переглянте "Надихнуло **FastAPI** на"
+     Бути мікрофреймоворком. Зробити легким комбінування та поєднання необхідних інструментів та частин.
+
+     Мати просту та легку у використанні систему маршрутизації.
+
+
+### <a href="https://requests.readthedocs.io" class="external-link" target="_blank">Requests</a>
+
+**FastAPI** насправді не є альтернативою **Requests**. Сфера їх застосування дуже різна.
+
+Насправді цілком звична річ використовувати Requests *всередині* програми FastAPI.
+
+Але все ж FastAPI черпав натхнення з Requests.
+
+**Requests** — це бібліотека для *взаємодії* з API (як клієнт), а **FastAPI** — це бібліотека для *створення* API (як сервер).
+
+Вони більш-менш знаходяться на протилежних кінцях, доповнюючи одна одну.
+
+Requests мають дуже простий та інтуїтивно зрозумілий дизайн, дуже простий у використанні, з розумними параметрами за замовчуванням. Але в той же час він дуже потужний і налаштовується.
+
+Ось чому, як сказано на офіційному сайті:
+
+> Requests є одним із найбільш завантажуваних пакетів Python усіх часів
+
+Використовувати його дуже просто. Наприклад, щоб виконати запит `GET`, ви повинні написати:
+
+```Python
+response = requests.get("http://example.com/some/url")
+```
+
+Відповідна операція *роуту* API FastAPI може виглядати так:
+
+```Python hl_lines="1"
+@app.get("/some/url")
+def read_url():
+     return {"message": "Hello World"}
+```
+
+Зверніть увагу на схожість у `requests.get(...)` і `@app.get(...)`.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     * Майте простий та інтуїтивно зрозумілий API.
+     * Використовуйте імена (операції) методів HTTP безпосередньо, простим та інтуїтивно зрозумілим способом.
+     * Розумні параметри за замовчуванням, але потужні налаштування.
+
+
+### <a href="https://swagger.io/" class="external-link" target="_blank">Swagger</a> / <a href="https://github.com/OAI /OpenAPI-Specification/" class="external-link" target="_blank">OpenAPI</a>
+
+Головною функцією, яку я хотів від Django REST Framework, була автоматична API документація.
+
+Потім я виявив, що існує стандарт для документування API з використанням JSON (або YAML, розширення JSON) під назвою Swagger.
+
+І вже був створений веб-інтерфейс користувача для Swagger API. Отже, можливість генерувати документацію Swagger для API дозволить використовувати цей веб-інтерфейс автоматично.
+
+У якийсь момент Swagger було передано Linux Foundation, щоб перейменувати його на OpenAPI.
+
+Тому, коли говорять про версію 2.0, прийнято говорити «Swagger», а про версію 3+ «OpenAPI».
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Прийняти і використовувати відкритий стандарт для специфікацій API замість спеціальної схеми.
+
+     Інтегрувати інструменти інтерфейсу на основі стандартів:
+
+     * <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Інтерфейс Swagger</a>
+     * <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>
+
+     Ці два було обрано через те, що вони досить популярні та стабільні, але, виконавши швидкий пошук, ви можете знайти десятки додаткових альтернативних інтерфейсів для OpenAPI (які можна використовувати з **FastAPI**).
+
+### Фреймворки REST для Flask
+
+Існує кілька фреймворків Flask REST, але, витративши час і роботу на їх дослідження, я виявив, що багато з них припинено або залишено, з кількома постійними проблемами, які зробили їх непридатними.
+
+### <a href="https://marshmallow.readthedocs.io/en/stable/" class="external-link" target="_blank">Marshmallow</a>
+
+Однією з головних функцій, необхідних для систем API, є "<abbr title="також звана marshalling, conversion">серіалізація</abbr>", яка бере дані з коду (Python) і перетворює їх на щось, що можна надіслати через мережу. Наприклад, перетворення об’єкта, що містить дані з бази даних, на об’єкт JSON. Перетворення об’єктів `datetime` на строки тощо.
+
+Іншою важливою функцією, необхідною для API, є перевірка даних, яка забезпечує дійсність даних за певними параметрами. Наприклад, що деяке поле є `int`, а не деяка випадкова строка. Це особливо корисно для вхідних даних.
+
+Без системи перевірки даних вам довелося б виконувати всі перевірки вручну, у коді.
+
+Marshmallow створено для забезпечення цих функцій. Це чудова бібліотека, і я часто нею користувався раніше.
+
+Але він був створений до того, як існували підказки типу Python. Отже, щоб визначити кожну <abbr title="визначення того, як дані повинні бути сформовані">схему</abbr>, вам потрібно використовувати спеціальні утиліти та класи, надані Marshmallow.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Використовувати код для автоматичного визначення "схем", які надають типи даних і перевірку.
+
+### <a href="https://webargs.readthedocs.io/en/latest/" class="external-link" target="_blank">Webargs</a>
+
+Іншою важливою функцією, необхідною для API, є <abbr title="читання та перетворення даних Python">аналіз</abbr> даних із вхідних запитів.
+
+Webargs — це інструмент, створений, щоб забезпечити це поверх кількох фреймворків, включаючи Flask.
+
+Він використовує Marshmallow в основі для перевірки даних. І створений тими ж розробниками.
+
+Це чудовий інструмент, і я також часто використовував його, перш ніж створити **FastAPI**.
+
+!!! Інформація
+     Webargs був створений тими ж розробниками Marshmallow.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Мати автоматичну перевірку даних вхідного запиту.
+
+### <a href="https://apispec.readthedocs.io/en/stable/" class="external-link" target="_blank">APISpec</a>
+
+Marshmallow і Webargs забезпечують перевірку, аналіз і серіалізацію як плагіни.
+
+Але документація досі відсутня. Потім було створено APISpec.
+
+Це плагін для багатьох фреймворків (також є плагін для Starlette).
+
+Принцип роботи полягає в тому, що ви пишете визначення схеми, використовуючи формат YAML, у docstring кожної функції, що обробляє маршрут.
+
+І він генерує схеми OpenAPI.
+
+Так це працює у Flask, Starlette, Responder тощо.
+
+Але потім ми знову маємо проблему наявності мікросинтаксису всередині Python строки (великий YAML).
+
+Редактор тут нічим не може допомогти. І якщо ми змінимо параметри чи схеми Marshmallow і забудемо також змінити цю строку документа YAML, згенерована схема буде застарілою.
+
+!!! Інформація
+     APISpec був створений тими ж розробниками Marshmallow.
+
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Підтримувати відкритий стандарт API, OpenAPI.
+
+### <a href="https://flask-apispec.readthedocs.io/en/latest/" class="external-link" target="_blank">Flask-apispec</a>
+
+Це плагін Flask, який об’єднує Webargs, Marshmallow і APISpec.
+
+Він використовує інформацію з Webargs і Marshmallow для автоматичного створення схем OpenAPI за допомогою APISpec.
+
+Це чудовий інструмент, дуже недооцінений. Він має бути набагато популярнішим, ніж багато плагінів Flask. Це може бути пов’язано з тим, що його документація надто стисла й абстрактна.
+
+Це вирішило необхідність писати YAML (інший синтаксис) всередині рядків документів Python.
+
+Ця комбінація Flask, Flask-apispec із Marshmallow і Webargs була моїм улюбленим бекенд-стеком до створення **FastAPI**.
+
+Їі використання призвело до створення кількох генераторів повного стека Flask. Це основний стек, який я (та кілька зовнішніх команд) використовував досі:
+
+* <a href="https://github.com/tiangolo/full-stack" class="external-link" target="_blank">https://github.com/tiangolo/full-stack</a>
+* <a href="https://github.com/tiangolo/full-stack-flask-couchbase" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-flask-couchbase</a>
+* <a href="https://github.com/tiangolo/full-stack-flask-couchdb" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-flask-couchdb</a>
+
+І ці самі генератори повного стеку були основою [**FastAPI** генераторів проектів](project-generation.md){.internal-link target=_blank}.
+
+!!! Інформація
+     Flask-apispec був створений тими ж розробниками Marshmallow.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Створення схеми OpenAPI автоматично з того самого коду, який визначає серіалізацію та перевірку.
+
+### <a href="https://nestjs.com/" class="external-link" target="_blank">NestJS</a> (та <a href="https://angular.io/ " class="external-link" target="_blank">Angular</a>)
+
+Це навіть не Python, NestJS — це фреймворк NodeJS JavaScript (TypeScript), натхненний Angular.
+
+Це досягає чогось подібного до того, що можна зробити з Flask-apispec.
+
+Він має інтегровану систему впровадження залежностей, натхненну Angular two. Він потребує попередньої реєстрації «injectables» (як і всі інші системи впровадження залежностей, які я знаю), тому це збільшує багатослівність та повторення коду.
+
+Оскільки параметри описані за допомогою типів TypeScript (подібно до підказок типу Python), підтримка редактора досить хороша.
+
+Але оскільки дані TypeScript не зберігаються після компіляції в JavaScript, вони не можуть покладатися на типи для визначення перевірки, серіалізації та документації одночасно. Через це та деякі дизайнерські рішення, щоб отримати перевірку, серіалізацію та автоматичну генерацію схеми, потрібно додати декоратори в багатьох місцях. Таким чином код стає досить багатослівним.
+
+Він не дуже добре обробляє вкладені моделі. Отже, якщо тіло JSON у запиті є об’єктом JSON із внутрішніми полями, які, у свою чергу, є вкладеними об’єктами JSON, його неможливо належним чином задокументувати та перевірити.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Використовувати типи Python, щоб мати чудову підтримку редактора.
+
+     Мати потужну систему впровадження залежностей. Знайдіть спосіб звести до мінімуму повторення коду.
+
+### <a href="https://sanic.readthedocs.io/en/latest/" class="external-link" target="_blank">Sanic</a>
+
+Це був один із перших надзвичайно швидких фреймворків Python на основі `asyncio`. Він був дуже схожий на Flask.
+
+!!! Примітка "Технічні деталі"
+     Він використовував <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> замість стандартного циклу Python `asyncio`. Ось що зробило його таким швидким.
+
+     Це явно надихнуло Uvicorn і Starlette, які зараз швидші за Sanic у відкритих тестах.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Знайти спосіб отримати божевільну продуктивність.
+
+     Ось чому **FastAPI** базується на Starlette, оскільки це найшвидша доступна структура (перевірена тестами сторонніх розробників).
+
+### <a href="https://falconframework.org/" class="external-link" target="_blank">Falcon</a>
+
+Falcon — ще один високопродуктивний фреймворк Python, він розроблений як мінімальний і працює як основа інших фреймворків, таких як Hug.
+
+Він розроблений таким чином, щоб мати функції, які отримують два параметри, один «запит» і один «відповідь». Потім ви «читаєте» частини запиту та «записуєте» частини у відповідь. Через такий дизайн неможливо оголосити параметри запиту та тіла за допомогою стандартних підказок типу Python як параметри функції.
+
+Таким чином, перевірка даних, серіалізація та документація повинні виконуватися в коді, а не автоматично. Або вони повинні бути реалізовані як фреймворк поверх Falcon, як Hug. Така сама відмінність спостерігається в інших фреймворках, натхненних дизайном Falcon, що мають один об’єкт запиту та один об’єкт відповіді як параметри.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Знайти способи отримати чудову продуктивність.
+
+     Разом із Hug (оскільки Hug базується на Falcon) надихнув **FastAPI** оголосити параметр `response` у функціях.
+
+     Хоча у FastAPI це необов’язково, і використовується в основному для встановлення заголовків, файлів cookie та альтернативних кодів стану.
+
+### <a href="https://moltenframework.com/" class="external-link" target="_blank">Molten</a>
+
+Я відкрив для себе Molten на перших етапах створення **FastAPI**. І він має досить схожі ідеї:
+
+* Базується на підказках типу Python.
+* Перевірка та документація цих типів.
+* Система впровадження залежностей.
+
+Він не використовує перевірку даних, серіалізацію та бібліотеку документації сторонніх розробників, як Pydantic, він має свою власну. Таким чином, ці визначення типів даних не можна було б використовувати повторно так легко.
+
+Це вимагає трохи більш докладних конфігурацій. І оскільки він заснований на WSGI (замість ASGI), він не призначений для використання високопродуктивних інструментів, таких як Uvicorn, Starlette і Sanic.
+
+Система впровадження залежностей вимагає попередньої реєстрації залежностей, і залежності вирішуються на основі оголошених типів. Отже, неможливо оголосити більше ніж один «компонент», який надає певний тип.
+
+Маршрути оголошуються в одному місці з використанням функцій, оголошених в інших місцях (замість використання декораторів, які можна розмістити безпосередньо поверх функції, яка обробляє кінцеву точку). Це ближче до того, як це робить Django, ніж до Flask (і Starlette). Він розділяє в коді речі, які відносно тісно пов’язані.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Визначити додаткові перевірки для типів даних, використовуючи значення "за замовчуванням" атрибутів моделі. Це покращує підтримку редактора, а раніше вона була недоступна в Pydantic.
+
+     Це фактично надихнуло оновити частини Pydantic, щоб підтримувати той самий стиль оголошення перевірки (всі ці функції вже доступні в Pydantic).
+
+### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+
+Hug був одним із перших фреймворків, який реалізував оголошення типів параметрів API за допомогою підказок типу Python. Це була чудова ідея, яка надихнула інші інструменти зробити те саме.
+
+Він використовував спеціальні типи у своїх оголошеннях замість стандартних типів Python, але це все одно був величезний крок вперед.
+
+Це також був один із перших фреймворків, який генерував спеціальну схему, що оголошувала весь API у JSON.
+
+Він не базувався на таких стандартах, як OpenAPI та JSON Schema. Тому було б непросто інтегрувати його з іншими інструментами, як-от Swagger UI. Але знову ж таки, це була дуже інноваційна ідея.
+
+Він має цікаву незвичайну функцію: використовуючи ту саму структуру, можна створювати API, а також CLI.
+
+Оскільки він заснований на попередньому стандарті для синхронних веб-фреймворків Python (WSGI), він не може працювати з Websockets та іншими речами, хоча він також має високу продуктивність.
+
+!!! Інформація
+     Hug створив Тімоті Крослі, той самий творець <a href="https://github.com/timothycrosley/isort" class="external-link" target="_blank">`isort`</a>, чудовий інструмент для автоматичного сортування імпорту у файлах Python.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Hug надихнув частину APIStar і був одним із найбільш перспективних інструментів, поряд із APIStar.
+
+     Hug надихнув **FastAPI** на використання підказок типу Python для оголошення параметрів і автоматичного створення схеми, що визначає API.
+
+     Hug надихнув **FastAPI** оголосити параметр `response` у функціях для встановлення заголовків і файлів cookie.
+
+### <a href="https://github.com/encode/apistar" class="external-link" target="_blank">APIStar</a> (<= 0,5)
+
+Безпосередньо перед тим, як вирішити створити **FastAPI**, я знайшов сервер **APIStar**. Він мав майже все, що я шукав, і мав чудовий дизайн.
+
+Це була одна з перших реалізацій фреймворку, що використовує підказки типу Python для оголошення параметрів і запитів, яку я коли-небудь бачив (до NestJS і Molten). Я знайшов його більш-менш одночасно з Hug. Але APIStar використовував стандарт OpenAPI.
+
+Він мав автоматичну перевірку даних, серіалізацію даних і генерацію схеми OpenAPI на основі підказок того самого типу в кількох місцях.
+
+Визначення схеми тіла не використовували ті самі підказки типу Python, як Pydantic, воно було трохи схоже на Marshmallow, тому підтримка редактора була б не такою хорошою, але все ж APIStar був найкращим доступним варіантом.
+
+Він мав найкращі показники продуктивності на той час (перевершив лише Starlette).
+
+Спочатку він не мав автоматичного веб-інтерфейсу документації API, але я знав, що можу додати до нього інтерфейс користувача Swagger.
+
+Він мав систему введення залежностей. Він вимагав попередньої реєстрації компонентів, як і інші інструменти, розглянуті вище. Але все одно це була чудова функція.
+
+Я ніколи не міг використовувати його в повноцінному проекті, оскільки він не мав інтеграції безпеки, тому я не міг замінити всі функції, які мав, генераторами повного стеку на основі Flask-apispec. У моїх невиконаних проектах я мав створити запит на вилучення, додавши цю функцію.
+
+Але потім фокус проекту змінився.
+
+Це вже не був веб-фреймворк API, оскільки творцю потрібно було зосередитися на Starlette.
+
+Тепер APIStar — це набір інструментів для перевірки специфікацій OpenAPI, а не веб-фреймворк.
+
+!!! Інформація
+     APIStar створив Том Крісті. Той самий хлопець, який створив:
+
+     * Django REST Framework
+     * Starlette (на якому базується **FastAPI**)
+     * Uvicorn (використовується Starlette і **FastAPI**)
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Існувати.
+
+     Ідею оголошення кількох речей (перевірки даних, серіалізації та документації) за допомогою тих самих типів Python, які в той же час забезпечували чудову підтримку редактора, я вважав геніальною ідеєю.
+
+     І після тривалого пошуку подібної структури та тестування багатьох різних альтернатив, APIStar став найкращим доступним варіантом.
+
+     Потім APIStar перестав існувати як сервер, і було створено Starlette, який став новою кращою основою для такої системи. Це стало останнім джерелом натхнення для створення **FastAPI**. Я вважаю **FastAPI** «духовним спадкоємцем» APIStar, удосконалюючи та розширюючи функції, систему введення тексту та інші частини на основі досвіду, отриманого від усіх цих попередніх інструментів.
+
+## Використовується **FastAPI**
+
+### <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a>
+
+Pydantic — це бібліотека для визначення перевірки даних, серіалізації та документації (за допомогою схеми JSON) на основі підказок типу Python.
+
+Це робить його надзвичайно інтуїтивним.
+
+Його можна порівняти з Marshmallow. Хоча він швидший за Marshmallow у тестах. Оскільки він базується на тих самих підказках типу Python, підтримка редактора чудова.
+
+!!! Перегляньте "**FastAPI** використовує його для"
+     Виконання перевірки всіх даних, серіалізації даних і автоматичної документацію моделі (на основі схеми JSON).
+
+     Потім **FastAPI** бере ці дані схеми JSON і розміщує їх у OpenAPI, окремо від усіх інших речей, які він робить.
+
+### <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a>
+
+Starlette — це легкий фреймворк/набір інструментів <abbr title="The new standard for build asynchronous Python web">ASGI</abbr>, який ідеально підходить для створення високопродуктивних asyncio сервісів.
+
+Він дуже простий та інтуїтивно зрозумілий. Його розроблено таким чином, щоб його можна було легко розширювати та мати модульні компоненти.
+
+Він має:
+
+* Серйозно вражаючу продуктивність.
+* Підтримку WebSocket.
+* Фонові завдання в процесі.
+* Події запуску та завершення роботи.
+* Тестового клієнта, побудований на HTTPX.
+* CORS, GZip, статичні файли, потокові відповіді.
+* Підтримку сеансів і файлів cookie.
+* 100% покриття тестом.
+* 100% анотовану кодову базу.
+* Кілька жорстких залежностей.
+
+Starlette наразі є найшвидшим фреймворком Python із перевірених. Перевершує лише Uvicorn, який є не фреймворком, а сервером.
+
+Starlette надає всі основні функції веб-мікрофреймворку.
+
+Але він не забезпечує автоматичної перевірки даних, серіалізації чи документації.
+
+Це одна з головних речей, які **FastAPI** додає зверху, все на основі підказок типу Python (з використанням Pydantic). Це, а також система впровадження залежностей, утиліти безпеки, створення схеми OpenAPI тощо.
+
+!!! Примітка "Технічні деталі"
+     ASGI — це новий «стандарт», який розробляється членами основної команди Django. Це ще не «стандарт Python» (PEP), хоча вони в процесі цього.
+
+     Тим не менш, він уже використовується як «стандарт» кількома інструментами. Це значно покращує сумісність, оскільки ви можете переключити Uvicorn на будь-який інший сервер ASGI (наприклад, Daphne або Hypercorn), або ви можете додати інструменти, сумісні з ASGI, як-от `python-socketio`.
+
+!!! Перегляньте "**FastAPI** використовує його для"
+     Керування всіма основними веб-частинами. Додавання функцій зверху.
+
+     Сам клас `FastAPI` безпосередньо успадковує клас `Starlette`.
+
+     Отже, усе, що ви можете робити зі Starlette, ви можете робити це безпосередньо за допомогою **FastAPI**, оскільки це, по суті, Starlette на стероїдах.
+
+### <a href="https://www.uvicorn.org/" class="external-link" target="_blank">Uvicorn</a>
+
+Uvicorn — це блискавичний сервер ASGI, побудований на uvloop і httptools.
+
+Це не веб-фреймворк, а сервер. Наприклад, він не надає інструментів для маршрутизації. Це те, що фреймворк на кшталт Starlette (або **FastAPI**) забезпечить поверх нього.
+
+Це рекомендований сервер для Starlette і **FastAPI**.
+
+!!! Перегляньте "**FastAPI** рекомендує це як"
+     Основний веб-сервер для запуску програм **FastAPI**.
+
+     Ви можете поєднати його з Gunicorn, щоб мати асинхронний багатопроцесний сервер.
+
+     Додаткову інформацію див. у розділі [Розгортання](deployment/index.md){.internal-link target=_blank}.
+
+## Орієнтири та швидкість
+
+Щоб зрозуміти, порівняти та побачити різницю між Uvicorn, Starlette і FastAPI, перегляньте розділ про [Бенчмарки](benchmarks.md){.internal-link target=_blank}.
diff --git a/docs/uk/docs/fastapi-people.md b/docs/uk/docs/fastapi-people.md
new file mode 100644
index 000000000..b32f0e5ce
--- /dev/null
+++ b/docs/uk/docs/fastapi-people.md
@@ -0,0 +1,178 @@
+# Люди FastAPI
+
+FastAPI має дивовижну спільноту, яка вітає людей різного походження.
+
+## Творець – Супроводжувач
+
+Привіт! 👋
+
+Це я:
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.maintainers %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Answers: {{ user.answers }}</div><div class="count">Pull Requests: {{ user.prs }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+Я - творець і супроводжувач **FastAPI**. Детальніше про це можна прочитати в [Довідка FastAPI - Отримати довідку - Зв'язатися з автором](help-fastapi.md#connect-with-the-author){.internal-link target=_blank}.
+
+...Але тут я хочу показати вам спільноту.
+
+---
+
+**FastAPI** отримує велику підтримку від спільноти. І я хочу відзначити їхній внесок.
+
+Це люди, які:
+
+* [Допомагають іншим із проблемами (запитаннями) у GitHub](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank}.
+* [Створюють пул реквести](help-fastapi.md#create-a-pull-request){.internal-link target=_blank}.
+* Переглядають пул реквести, [особливо важливо для перекладів](contributing.md#translations){.internal-link target=_blank}.
+
+Оплески їм. 👏 🙇
+
+## Найбільш активні користувачі минулого місяця
+
+Це користувачі, які [найбільше допомагали іншим із проблемами (запитаннями) у GitHub](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank} протягом минулого місяця. ☕
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.last_month_active %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Issues replied: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+## Експерти
+
+Ось **експерти FastAPI**. 🤓
+
+Це користувачі, які [найбільше допомагали іншим із проблемами (запитаннями) у GitHub](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank} протягом *всього часу*.
+
+Вони зарекомендували себе як експерти, допомагаючи багатьом іншим. ✨
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.experts %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Issues replied: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+## Найкращі контрибютори
+
+Ось **Найкращі контрибютори**. 👷
+
+Ці користувачі [створили найбільшу кількість пул реквестів](help-fastapi.md#create-a-pull-request){.internal-link target=_blank} які були *змержені*.
+
+Вони надали програмний код, документацію, переклади тощо. 📦
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.top_contributors %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Pull Requests: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+Є багато інших контрибюторів (більше сотні), їх усіх можна побачити на сторінці <a href="https://github.com/tiangolo/fastapi/graphs/contributors" class="external-link" target="_blank">FastAPI GitHub Contributors</a>. 👷
+
+## Найкращі рецензенти
+
+Ці користувачі є **Найкращими рецензентами**. 🕵️
+
+### Рецензенти на переклади
+
+Я розмовляю лише кількома мовами (і не дуже добре 😅). Отже, рецензенти – це ті, хто має [**повноваження схвалювати переклади**](contributing.md#translations){.internal-link target=_blank} документації. Без них не було б документації кількома іншими мовами.
+
+---
+
+**Найкращі рецензенти** 🕵️ переглянули більшість пул реквестів від інших, забезпечуючи якість коду, документації і особливо **перекладів**.
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.top_reviewers %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Reviews: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+## Спонсори
+
+Це **Спонсори**. 😎
+
+Вони підтримують мою роботу з **FastAPI** (та іншими), переважно через <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub Sponsors</a>.
+
+{% if sponsors %}
+
+{% if sponsors.gold %}
+
+### Золоті спонсори
+
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+{% if sponsors.silver %}
+
+### Срібні спонсори
+
+{% for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+{% if sponsors.bronze %}
+
+### Бронзові спонсори
+
+{% for sponsor in sponsors.bronze -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+{% endif %}
+
+### Індивідуальні спонсори
+
+{% if github_sponsors %}
+{% for group in github_sponsors.sponsors %}
+
+<div class="user-list user-list-center">
+
+{% for user in group %}
+{% if user.login not in sponsors_badge.logins %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a></div>
+
+{% endif %}
+{% endfor %}
+
+</div>
+
+{% endfor %}
+{% endif %}
+
+## Про дані - технічні деталі
+
+Основна мета цієї сторінки – висвітлити зусилля спільноти, щоб допомогти іншим.
+
+Особливо враховуючи зусилля, які зазвичай менш помітні, а в багатьох випадках більш важкі, як-от допомога іншим із проблемами та перегляд пул реквестів перекладів.
+
+Дані розраховуються щомісяця, ви можете ознайомитися з <a href="https://github.com/tiangolo/fastapi/blob/master/.github/actions/people/app/main.py" class="external-link" target="_blank">вихідним кодом тут</a>.
+
+Тут я також підкреслюю внески спонсорів.
+
+Я також залишаю за собою право оновлювати алгоритми підрахунку, види рейтингів, порогові значення тощо (про всяк випадок 🤷).
diff --git a/docs/uk/docs/python-types.md b/docs/uk/docs/python-types.md
new file mode 100644
index 000000000..6c8e29016
--- /dev/null
+++ b/docs/uk/docs/python-types.md
@@ -0,0 +1,448 @@
+# Вступ до типів Python
+
+Python підтримує додаткові "підказки типу" ("type hints") (також звані "анотаціями типу" ("type annotations")).
+
+Ці **"type hints"** є спеціальним синтаксисом, що дозволяє оголошувати <abbr title="наприклад: str, int, float, bool">тип</abbr> змінної.
+
+За допомогою оголошення типів для ваших змінних, редактори та інструменти можуть надати вам кращу підтримку.
+
+Це просто **швидкий посібник / нагадування** про анотації типів у Python. Він покриває лише мінімум, необхідний щоб використовувати їх з **FastAPI**... що насправді дуже мало.
+
+**FastAPI** повністю базується на цих анотаціях типів, вони дають йому багато переваг.
+
+Але навіть якщо ви ніколи не використаєте **FastAPI**, вам буде корисно дізнатись трохи про них.
+
+!!! note
+    Якщо ви експерт у Python і ви вже знаєте усе про анотації типів - перейдіть до наступного розділу.
+
+## Мотивація
+
+Давайте почнемо з простого прикладу:
+
+```Python
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+Виклик цієї програми виводить:
+
+```
+John Doe
+```
+
+Функція виконує наступне:
+
+* Бере `first_name` та `last_name`.
+* Конвертує кожну літеру кожного слова у верхній регістр за допомогою `title()`.
+* <abbr title="З’єднує їх, як одне ціле. З вмістом один за одним.">Конкатенує</abbr> їх разом із пробілом по середині.
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+### Редагуйте це
+
+Це дуже проста програма.
+
+Але тепер уявіть, що ви писали це з нуля.
+
+У певний момент ви розпочали б визначення функції, у вас були б готові параметри...
+
+Але тоді вам потрібно викликати "той метод, який переводить першу літеру у верхній регістр".
+
+Це буде `upper`? Чи `uppercase`? `first_uppercase`? `capitalize`?
+
+Тоді ви спробуєте давнього друга програміста - автозаповнення редактора коду.
+
+Ви надрукуєте перший параметр функції, `first_name`, тоді крапку (`.`), а тоді натиснете `Ctrl+Space`, щоб запустити автозаповнення.
+
+Але, на жаль, ви не отримаєте нічого корисного:
+
+<img src="/img/python-types/image01.png">
+
+### Додайте типи
+
+Давайте змінимо один рядок з попередньої версії.
+
+Ми змінимо саме цей фрагмент, параметри функції, з:
+
+```Python
+    first_name, last_name
+```
+
+на:
+
+```Python
+    first_name: str, last_name: str
+```
+
+Ось і все.
+
+Це "type hints":
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial002.py!}
+```
+
+Це не те саме, що оголошення значень за замовчуванням, як це було б з:
+
+```Python
+    first_name="john", last_name="doe"
+```
+
+Це зовсім інше.
+
+Ми використовуємо двокрапку (`:`), не дорівнює (`=`).
+
+І додавання анотації типу зазвичай не змінює того, що сталось би без них.
+
+Але тепер, уявіть що ви посеред процесу створення функції, але з анотаціями типів.
+
+В цей же момент, ви спробуєте викликати автозаповнення з допомогою `Ctrl+Space` і побачите:
+
+<img src="/img/python-types/image02.png">
+
+Разом з цим, ви можете прокручувати, переглядати опції, допоки ви не знайдете одну, що звучить схоже:
+
+<img src="/img/python-types/image03.png">
+
+## Більше мотивації
+
+Перевірте цю функцію, вона вже має анотацію типу:
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial003.py!}
+```
+
+Оскільки редактор знає типи змінних, ви не тільки отримаєте автозаповнення, ви також отримаєте перевірку помилок:
+
+<img src="/img/python-types/image04.png">
+
+Тепер ви знаєте, щоб виправити це, вам потрібно перетворити `age` у строку з допомогою `str(age)`:
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial004.py!}
+```
+
+## Оголошення типів
+
+Щойно ви побачили основне місце для оголошення анотацій типу. Як параметри функції.
+
+Це також основне місце, де ви б їх використовували у **FastAPI**.
+
+### Прості типи
+
+Ви можете оголошувати усі стандартні типи у Python, не тільки `str`.
+
+Ви можете використовувати, наприклад:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial005.py!}
+```
+
+### Generic-типи з параметрами типів
+
+Існують деякі структури даних, які можуть містити інші значення, наприклад `dict`, `list`, `set` та `tuple`. І внутрішні значення також можуть мати свій тип.
+
+Ці типи, які мають внутрішні типи, називаються "**generic**" типами. І оголосити їх можна навіть із внутрішніми типами.
+
+Щоб оголосити ці типи та внутрішні типи, ви можете використовувати стандартний модуль Python `typing`. Він існує спеціально для підтримки анотацій типів.
+
+#### Новіші версії Python
+
+Синтаксис із використанням `typing` **сумісний** з усіма версіями, від Python 3.6 до останніх, включаючи Python 3.9, Python 3.10 тощо.
+
+У міру розвитку Python **новіші версії** мають покращену підтримку анотацій типів і в багатьох випадках вам навіть не потрібно буде імпортувати та використовувати модуль `typing` для оголошення анотацій типу.
+
+Якщо ви можете вибрати новішу версію Python для свого проекту, ви зможете скористатися цією додатковою простотою. Дивіться кілька прикладів нижче.
+
+#### List (список)
+
+Наприклад, давайте визначимо змінну, яка буде `list` із `str`.
+
+=== "Python 3.8 і вище"
+
+    З модуля `typing`, імпортуємо `List` (з великої літери `L`):
+
+    ``` Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+    Оголосимо змінну з тим самим синтаксисом двокрапки (`:`).
+
+    Як тип вкажемо `List`, який ви імпортували з `typing`.
+
+    Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    Оголосимо змінну з тим самим синтаксисом двокрапки (`:`).
+
+    Як тип вкажемо `list`.
+
+    Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006_py39.py!}
+    ```
+
+!!! info
+    Ці внутрішні типи в квадратних дужках називаються "параметрами типу".
+
+    У цьому випадку, `str` це параметр типу переданий у `List` (або `list` у Python 3.9 і вище).
+
+Це означає: "змінна `items` це `list`, і кожен з елементів у цьому списку - `str`".
+
+!!! tip
+    Якщо ви використовуєте Python 3.9 і вище, вам не потрібно імпортувати `List` з `typing`, ви можете використовувати натомість тип `list`.
+
+Зробивши це, ваш редактор може надати підтримку навіть під час обробки елементів зі списку:
+
+<img src="/img/python-types/image05.png">
+
+Без типів цього майже неможливо досягти.
+
+Зверніть увагу, що змінна `item` є одним із елементів у списку `items`.
+
+І все ж редактор знає, що це `str`, і надає підтримку для цього.
+
+#### Tuple and Set (кортеж та набір)
+
+Ви повинні зробити те ж саме, щоб оголосити `tuple` і `set`:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial007.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial007_py39.py!}
+    ```
+
+Це означає:
+
+* Змінна `items_t` це `tuple` з 3 елементами, `int`, ще `int`, та `str`.
+* Змінна `items_s` це `set`, і кожен його елемент типу `bytes`.
+
+#### Dict (словник)
+
+Щоб оголосити `dict`, вам потрібно передати 2 параметри типу, розділені комами.
+
+Перший параметр типу для ключа у `dict`.
+
+Другий параметр типу для значення у `dict`:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008_py39.py!}
+    ```
+
+Це означає:
+
+* Змінна `prices` це `dict`:
+    * Ключі цього `dict` типу `str` (наприклад, назва кожного елементу).
+    * Значення цього `dict` типу `float` (наприклад, ціна кожного елементу).
+
+#### Union (об'єднання)
+
+Ви можете оголосити, що змінна може бути будь-яким із **кількох типів**, наприклад, `int` або `str`.
+
+У Python 3.6 і вище (включаючи Python 3.10) ви можете використовувати тип `Union` з `typing` і вставляти в квадратні дужки можливі типи, які можна прийняти.
+
+У Python 3.10 також є **альтернативний синтаксис**, у якому ви можете розділити можливі типи за допомогою <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальної смуги (`|`)</abbr>.
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008b.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+    ```
+
+В обох випадках це означає, що `item` може бути `int` або `str`.
+
+#### Possibly `None` (Optional)
+
+Ви можете оголосити, що значення може мати тип, наприклад `str`, але також може бути `None`.
+
+У Python 3.6 і вище (включаючи Python 3.10) ви можете оголосити його, імпортувавши та використовуючи `Optional` з модуля `typing`.
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009.py!}
+```
+
+Використання `Optional[str]` замість просто `str` дозволить редактору допомогти вам виявити помилки, коли ви могли б вважати, що значенням завжди є `str`, хоча насправді воно також може бути `None`.
+
+`Optional[Something]` насправді є скороченням для `Union[Something, None]`, вони еквівалентні.
+
+Це також означає, що в Python 3.10 ви можете використовувати `Something | None`:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009.py!}
+    ```
+
+=== "Python 3.8 і вище - альтернатива"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009b.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial009_py310.py!}
+    ```
+
+#### Generic типи
+
+Ці типи, які приймають параметри типу у квадратних дужках, називаються **Generic types** or **Generics**, наприклад:
+
+=== "Python 3.8 і вище"
+
+    * `List`
+    * `Tuple`
+    * `Set`
+    * `Dict`
+    * `Union`
+    * `Optional`
+    * ...та інші.
+
+=== "Python 3.9 і вище"
+
+    Ви можете використовувати ті самі вбудовані типи, як generic (з квадратними дужками та типами всередині):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    І те саме, що й у Python 3.8, із модуля `typing`:
+
+    * `Union`
+    * `Optional`
+    * ...та інші.
+
+=== "Python 3.10 і вище"
+
+    Ви можете використовувати ті самі вбудовані типи, як generic (з квадратними дужками та типами всередині):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    І те саме, що й у Python 3.8, із модуля `typing`:
+
+    * `Union`
+    * `Optional` (так само як у Python 3.8)
+    * ...та інші.
+
+    У Python 3.10, як альтернатива використанню `Union` та `Optional`, ви можете використовувати <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальну смугу (`|`)</abbr> щоб оголосити об'єднання типів.
+
+### Класи як типи
+
+Ви також можете оголосити клас як тип змінної.
+
+Скажімо, у вас є клас `Person` з імʼям:
+
+```Python hl_lines="1-3"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Потім ви можете оголосити змінну типу `Person`:
+
+```Python hl_lines="6"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+І знову ж таки, ви отримуєте всю підтримку редактора:
+
+<img src="/img/python-types/image06.png">
+
+## Pydantic моделі
+
+<a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> це бібліотека Python для валідації даних.
+
+Ви оголошуєте «форму» даних як класи з атрибутами.
+
+І кожен атрибут має тип.
+
+Потім ви створюєте екземпляр цього класу з деякими значеннями, і він перевірить ці значення, перетворить їх у відповідний тип (якщо є потреба) і надасть вам об’єкт з усіма даними.
+
+І ви отримуєте всю підтримку редактора з цим отриманим об’єктом.
+
+Приклад з документації Pydantic:
+
+=== "Python 3.8 і вище"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py39.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py310.py!}
+    ```
+
+!!! info
+    Щоб дізнатись більше про <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic, перегляньте його документацію</a>.
+
+**FastAPI** повністю базується на Pydantic.
+
+Ви побачите набагато більше цього всього на практиці в [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank}.
+
+## Анотації типів у **FastAPI**
+
+**FastAPI** використовує ці підказки для виконання кількох речей.
+
+З **FastAPI** ви оголошуєте параметри з підказками типу, і отримуєте:
+
+* **Підтримку редактора**.
+* **Перевірку типів**.
+
+...і **FastAPI** використовує ті самі оголошення для:
+
+* **Визначення вимог**: з параметрів шляху запиту, параметрів запиту, заголовків, тіл, залежностей тощо.
+* **Перетворення даних**: із запиту в необхідний тип.
+* **Перевірка даних**: що надходять від кожного запиту:
+    * Генерування **автоматичних помилок**, що повертаються клієнту, коли дані недійсні.
+* **Документування** API за допомогою OpenAPI:
+    * який потім використовується для автоматичної інтерактивної документації користувальницьких інтерфейсів.
+
+Все це може здатися абстрактним. Не хвилюйтеся. Ви побачите все це в дії в [Туторіал - Посібник користувача](tutorial/index.md){.internal-link target=_blank}.
+
+Важливо те, що за допомогою стандартних типів Python в одному місці (замість того, щоб додавати більше класів, декораторів тощо), **FastAPI** зробить багато роботи за вас.
+
+!!! info
+    Якщо ви вже пройшли весь навчальний посібник і повернулися, щоб дізнатися більше про типи, ось хороший ресурс <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">"шпаргалка" від `mypy`</a>.
diff --git a/docs/uk/docs/tutorial/body.md b/docs/uk/docs/tutorial/body.md
new file mode 100644
index 000000000..9759e7f45
--- /dev/null
+++ b/docs/uk/docs/tutorial/body.md
@@ -0,0 +1,213 @@
+# Тіло запиту
+
+Коли вам потрібно надіслати дані з клієнта (скажімо, браузера) до вашого API, ви надсилаєте їх як **тіло запиту**.
+
+Тіло **запиту** — це дані, надіслані клієнтом до вашого API. Тіло **відповіді** — це дані, які ваш API надсилає клієнту.
+
+Ваш API майже завжди має надсилати тіло **відповіді**. Але клієнтам не обов’язково потрібно постійно надсилати тіла **запитів**.
+
+Щоб оголосити тіло **запиту**, ви використовуєте <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> моделі з усією їх потужністю та перевагами.
+
+!!! info
+    Щоб надіслати дані, ви повинні використовувати один із: `POST` (більш поширений), `PUT`, `DELETE` або `PATCH`.
+
+    Надсилання тіла із запитом `GET` має невизначену поведінку в специфікаціях, проте воно підтримується FastAPI лише для дуже складних/екстремальних випадків використання.
+
+    Оскільки це не рекомендується, інтерактивна документація з Swagger UI не відображатиме документацію для тіла запиту під час використання `GET`, і проксі-сервери в середині можуть не підтримувати її.
+
+## Імпортуйте `BaseModel` від Pydantic
+
+Спочатку вам потрібно імпортувати `BaseModel` з `pydantic`:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+## Створіть свою модель даних
+
+Потім ви оголошуєте свою модель даних як клас, який успадковується від `BaseModel`.
+
+Використовуйте стандартні типи Python для всіх атрибутів:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="7-11"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="5-9"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+Так само, як і при оголошенні параметрів запиту, коли атрибут моделі має значення за замовчуванням, він не є обов’язковим. В іншому випадку це потрібно. Використовуйте `None`, щоб зробити його необов'язковим.
+
+Наприклад, ця модель вище оголошує JSON "`об'єкт`" (або Python `dict`), як:
+
+```JSON
+{
+    "name": "Foo",
+    "description": "An optional description",
+    "price": 45.2,
+    "tax": 3.5
+}
+```
+
+...оскільки `description` і `tax` є необов'язковими (зі значенням за замовчуванням `None`), цей JSON "`об'єкт`" також буде дійсним:
+
+```JSON
+{
+    "name": "Foo",
+    "price": 45.2
+}
+```
+
+## Оголоси її як параметр
+
+Щоб додати модель даних до вашої *операції шляху*, оголосіть її так само, як ви оголосили параметри шляху та запиту:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+...і вкажіть її тип як модель, яку ви створили, `Item`.
+
+## Результати
+
+Лише з цим оголошенням типу Python **FastAPI** буде:
+
+* Читати тіло запиту як JSON.
+* Перетворювати відповідні типи (якщо потрібно).
+* Валідувати дані.
+    * Якщо дані недійсні, він поверне гарну та чітку помилку, вказуючи, де саме і які дані були неправильними.
+* Надавати отримані дані у параметрі `item`.
+    * Оскільки ви оголосили його у функції як тип `Item`, ви також матимете всю підтримку редактора (автозаповнення, тощо) для всіх атрибутів та їх типів.
+* Генерувати <a href="https://json-schema.org" class="external-link" target="_blank">JSON Schema</a> визначення для вашої моделі, ви також можете використовувати їх де завгодно, якщо це має сенс для вашого проекту.
+* Ці схеми будуть частиною згенерованої схеми OpenAPI і використовуватимуться автоматичною документацією інтерфейсу користувача.
+
+## Автоматична документація
+
+Схеми JSON ваших моделей будуть частиною вашої схеми, згенерованої OpenAPI, і будуть показані в інтерактивній API документації:
+
+<img src="/img/tutorial/body/image01.png">
+
+А також використовуватимуться в API документації всередині кожної *операції шляху*, якій вони потрібні:
+
+<img src="/img/tutorial/body/image02.png">
+
+## Підтримка редактора
+
+У вашому редакторі, всередині вашої функції, ви будете отримувати підказки типу та завершення скрізь (це б не сталося, якби ви отримали `dict` замість моделі Pydantic):
+
+<img src="/img/tutorial/body/image03.png">
+
+Ви також отримуєте перевірку помилок на наявність операцій з неправильним типом:
+
+<img src="/img/tutorial/body/image04.png">
+
+Це не випадково, весь каркас був побудований навколо цього дизайну.
+
+І він був ретельно перевірений на етапі проектування, перед будь-яким впровадженням, щоб переконатися, що він працюватиме з усіма редакторами.
+
+Були навіть деякі зміни в самому Pydantic, щоб підтримати це.
+
+Попередні скріншоти були зроблені у <a href="https://code.visualstudio.com" class="external-link" target="_blank">Visual Studio Code</a>.
+
+Але ви отримаєте ту саму підтримку редактора у <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> та більшість інших редакторів Python:
+
+<img src="/img/tutorial/body/image05.png">
+
+!!! tip
+    Якщо ви використовуєте <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> як ваш редактор, ви можете використати <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>.
+
+    Він покращує підтримку редакторів для моделей Pydantic за допомогою:
+
+    * автозаповнення
+    * перевірки типу
+    * рефакторингу
+    * пошуку
+    * інспекції
+
+## Використовуйте модель
+
+Усередині функції ви можете отримати прямий доступ до всіх атрибутів об’єкта моделі:
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/body/tutorial002.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/body/tutorial002_py310.py!}
+    ```
+
+## Тіло запиту + параметри шляху
+
+Ви можете одночасно оголошувати параметри шляху та тіло запиту.
+
+**FastAPI** розпізнає, що параметри функції, які відповідають параметрам шляху, мають бути **взяті з шляху**, а параметри функції, які оголошуються як моделі Pydantic, **взяті з тіла запиту**.
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/body/tutorial003.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="15-16"
+    {!> ../../../docs_src/body/tutorial003_py310.py!}
+    ```
+
+## Тіло запиту + шлях + параметри запиту
+
+Ви також можете оголосити параметри **тіло**, **шлях** і **запит** одночасно.
+
+**FastAPI** розпізнає кожен з них і візьме дані з потрібного місця.
+
+=== "Python 3.8 і вище"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial004.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial004_py310.py!}
+    ```
+
+Параметри функції будуть розпізнаватися наступним чином:
+
+* Якщо параметр також оголошено в **шляху**, він використовуватиметься як параметр шляху.
+* Якщо параметр має **сингулярний тип** (наприклад, `int`, `float`, `str`, `bool` тощо), він буде інтерпретуватися як параметр **запиту**.
+* Якщо параметр оголошується як тип **Pydantic моделі**, він інтерпретується як **тіло** запиту.
+
+!!! note
+    FastAPI буде знати, що значення "q" не є обов'язковим через значення за замовчуванням "= None".
+
+    `Optional` у `Optional[str]` не використовується FastAPI, але дозволить вашому редактору надати вам кращу підтримку та виявляти помилки.
+
+## Без Pydantic
+
+Якщо ви не хочете використовувати моделі Pydantic, ви також можете використовувати параметри **Body**. Перегляньте документацію для [Тіло – Кілька параметрів: сингулярні значення в тілі](body-multiple-params.md#singular-values-in-body){.internal-link target=_blank}.
diff --git a/docs/uk/docs/tutorial/cookie-params.md b/docs/uk/docs/tutorial/cookie-params.md
new file mode 100644
index 000000000..199b93839
--- /dev/null
+++ b/docs/uk/docs/tutorial/cookie-params.md
@@ -0,0 +1,96 @@
+# Параметри Cookie
+
+Ви можете визначити параметри Cookie таким же чином, як визначаються параметри `Query` і `Path`.
+
+## Імпорт `Cookie`
+
+Спочатку імпортуйте `Cookie`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+## Визначення параметрів `Cookie`
+
+Потім визначте параметри cookie, використовуючи таку ж конструкцію як для `Path` і `Query`.
+
+Перше значення це значення за замовчуванням, ви можете також передати всі додаткові параметри валідації чи анотації:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+!!! note "Технічні Деталі"
+    `Cookie` це "сестра" класів `Path` і `Query`. Вони наслідуються від одного батьківського класу `Param`.
+    Але пам'ятайте, що коли ви імпортуєте `Query`, `Path`, `Cookie` та інше з `fastapi`, це фактично функції, що повертають спеціальні класи.
+
+!!! info
+    Для визначення cookies ви маєте використовувати `Cookie`, тому що в іншому випадку параметри будуть інтерпритовані, як параметри запиту.
+
+## Підсумки
+
+Визначайте cookies за допомогою `Cookie`, використовуючи той же спільний шаблон, що і `Query` та `Path`.
diff --git a/docs/uk/docs/tutorial/encoder.md b/docs/uk/docs/tutorial/encoder.md
new file mode 100644
index 000000000..b6583341f
--- /dev/null
+++ b/docs/uk/docs/tutorial/encoder.md
@@ -0,0 +1,42 @@
+# JSON Compatible Encoder
+
+Існують випадки, коли вам може знадобитися перетворити тип даних (наприклад, модель Pydantic) в щось сумісне з JSON (наприклад, `dict`, `list`, і т. д.).
+
+Наприклад, якщо вам потрібно зберегти це в базі даних.
+
+Для цього, **FastAPI** надає `jsonable_encoder()` функцію.
+
+## Використання `jsonable_encoder`
+
+Давайте уявимо, що у вас є база даних `fake_db`, яка приймає лише дані, сумісні з JSON.
+
+Наприклад, вона не приймає об'єкти типу `datetime`, оскільки вони не сумісні з JSON.
+
+Отже, об'єкт типу `datetime` потрібно перетворити в рядок `str`, який містить дані в <a href="https://en.wikipedia.org/wiki/ISO_8601" class="external-link" target="_blank">ISO форматі</a>.
+
+Тим самим способом ця база даних не прийматиме об'єкт типу Pydantic model (об'єкт з атрибутами), а лише `dict`.
+
+Ви можете використовувати `jsonable_encoder` для цього.
+
+Вона приймає об'єкт, такий як Pydantic model, і повертає його версію, сумісну з JSON:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="4  21"
+    {!> ../../../docs_src/encoder/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="5  22"
+    {!> ../../../docs_src/encoder/tutorial001.py!}
+    ```
+
+У цьому прикладі вона конвертує Pydantic model у `dict`, а `datetime` у `str`.
+
+Результат виклику цієї функції - це щось, що можна кодувати з використанням стандарту Python <a href="https://docs.python.org/3/library/json.html#json.dumps" class="external-link" target="_blank">`json.dumps()`</a>.
+
+Вона не повертає велику строку `str`, яка містить дані у форматі JSON (як строка). Вона повертає стандартну структуру даних Python (наприклад `dict`) із значеннями та підзначеннями, які є сумісними з JSON.
+
+!!! Примітка
+    `jsonable_encoder` фактично використовується **FastAPI** внутрішньо для перетворення даних. Проте вона корисна в багатьох інших сценаріях.
diff --git a/docs/uk/docs/tutorial/extra-data-types.md b/docs/uk/docs/tutorial/extra-data-types.md
new file mode 100644
index 000000000..ec5ec0d18
--- /dev/null
+++ b/docs/uk/docs/tutorial/extra-data-types.md
@@ -0,0 +1,130 @@
+# Додаткові типи даних
+
+До цього часу, ви використовували загальнопоширені типи даних, такі як:
+
+* `int`
+* `float`
+* `str`
+* `bool`
+
+Але можна також використовувати більш складні типи даних.
+
+І ви все ще матимете ті ж можливості, які були показані до цього:
+
+* Чудова підтримка редактора.
+* Конвертація даних з вхідних запитів.
+* Конвертація даних для відповіді.
+* Валідація даних.
+* Автоматична анотація та документація.
+
+## Інші типи даних
+
+Ось додаткові типи даних для використання:
+
+* `UUID`:
+    * Стандартний "Універсальний Унікальний Ідентифікатор", який часто використовується як ідентифікатор у багатьох базах даних та системах.
+    * У запитах та відповідях буде представлений як `str`.
+* `datetime.datetime`:
+    * Пайтонівський `datetime.datetime`.
+    * У запитах та відповідях буде представлений як `str` в форматі ISO 8601, як: `2008-09-15T15:53:00+05:00`.
+* `datetime.date`:
+    * Пайтонівський `datetime.date`.
+    * У запитах та відповідях буде представлений як `str` в форматі ISO 8601, як: `2008-09-15`.
+* `datetime.time`:
+    * Пайтонівський `datetime.time`.
+    * У запитах та відповідях буде представлений як `str` в форматі ISO 8601, як: `14:23:55.003`.
+* `datetime.timedelta`:
+    * Пайтонівський `datetime.timedelta`.
+    * У запитах та відповідях буде представлений як `float` загальної кількості секунд.
+    * Pydantic також дозволяє представляти це як "ISO 8601 time diff encoding", <a href="https://pydantic-docs.helpmanual.io/usage/exporting_models/#json_encoders" class="external-link" target="_blank">більше інформації дивись у документації</a>.
+* `frozenset`:
+    * У запитах і відповідях це буде оброблено так само, як і `set`:
+        * У запитах список буде зчитано, дублікати будуть видалені та він буде перетворений на `set`.
+        * У відповідях, `set` буде перетворений на `list`.
+        * Згенерована схема буде вказувати, що значення `set` є унікальними (з використанням JSON Schema's `uniqueItems`).
+* `bytes`:
+    * Стандартний Пайтонівський `bytes`.
+    * У запитах і відповідях це буде оброблено як `str`.
+    * Згенерована схема буде вказувати, що це `str` з "форматом" `binary`.
+* `Decimal`:
+    * Стандартний Пайтонівський `Decimal`.
+    * У запитах і відповідях це буде оброблено так само, як і `float`.
+* Ви можете перевірити всі дійсні типи даних Pydantic тут: <a href="https://pydantic-docs.helpmanual.io/usage/types" class="external-link" target="_blank">типи даних Pydantic</a>.
+
+## Приклад
+
+Ось приклад *path operation* з параметрами, використовуючи деякі з вищезазначених типів.
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  3  13-17"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="1  2  11-15"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="1  2  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
+
+Зверніть увагу, що параметри всередині функції мають свій звичайний тип даних, і ви можете, наприклад, виконувати звичайні маніпуляції з датами, такі як:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="19-20"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
diff --git a/docs/uk/docs/tutorial/index.md b/docs/uk/docs/tutorial/index.md
new file mode 100644
index 000000000..e5bae74bc
--- /dev/null
+++ b/docs/uk/docs/tutorial/index.md
@@ -0,0 +1,80 @@
+# Туторіал - Посібник користувача
+
+У цьому посібнику показано, як користуватися **FastAPI** з більшістю його функцій, крок за кроком.
+
+Кожен розділ поступово надбудовується на попередні, але він структурований на окремі теми, щоб ви могли перейти безпосередньо до будь-якої конкретної, щоб вирішити ваші конкретні потреби API.
+
+Він також створений як довідник для роботи у майбутньому.
+
+Тож ви можете повернутися і побачити саме те, що вам потрібно.
+
+## Запустіть код
+
+Усі блоки коду можна скопіювати та використовувати безпосередньо (це фактично перевірені файли Python).
+
+Щоб запустити будь-який із прикладів, скопіюйте код у файл `main.py` і запустіть `uvicorn` за допомогою:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+**ДУЖЕ радимо** написати або скопіювати код, відредагувати його та запустити локально.
+
+Використання його у своєму редакторі – це те, що дійсно показує вам переваги FastAPI, бачите, як мало коду вам потрібно написати, всі перевірки типів, автозаповнення тощо.
+
+---
+
+## Встановлення FastAPI
+
+Першим кроком є встановлення FastAPI.
+
+Для туторіалу ви можете встановити його з усіма необов’язковими залежностями та функціями:
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[all]"
+
+---> 100%
+```
+
+</div>
+
+...який також включає `uvicorn`, який ви можете використовувати як сервер, який запускає ваш код.
+
+!!! note
+    Ви також можете встановити його частина за частиною.
+
+    Це те, що ви, ймовірно, зробили б, коли захочете розгорнути свою програму у виробничому середовищі:
+
+    ```
+    pip install fastapi
+    ```
+
+    Також встановіть `uvicorn`, щоб він працював як сервер:
+
+    ```
+    pip install "uvicorn[standard]"
+    ```
+
+    І те саме для кожної з опціональних залежностей, які ви хочете використовувати.
+
+## Розширений посібник користувача
+
+Існує також **Розширений посібник користувача**, який ви зможете прочитати пізніше після цього **Туторіал - Посібник користувача**.
+
+**Розширений посібник користувача** засновано на цьому, використовує ті самі концепції та навчає вас деяким додатковим функціям.
+
+Але вам слід спочатку прочитати **Туторіал - Посібник користувача** (те, що ви зараз читаєте).
+
+Він розроблений таким чином, що ви можете створити повну програму лише за допомогою **Туторіал - Посібник користувача**, а потім розширити її різними способами, залежно від ваших потреб, використовуючи деякі з додаткових ідей з **Розширеного посібника користувача** .
diff --git a/docs/uk/mkdocs.yml b/docs/uk/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/uk/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml
diff --git a/docs/ur/docs/benchmarks.md b/docs/ur/docs/benchmarks.md
new file mode 100644
index 000000000..9fc793e6f
--- /dev/null
+++ b/docs/ur/docs/benchmarks.md
@@ -0,0 +1,52 @@
+# بینچ مارکس
+
+انڈیپنڈنٹ ٹیک امپور بینچ مارک **FASTAPI** Uvicorn کے تحت چلنے والی ایپلی کیشنز کو <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank"> ایک تیز رفتار Python فریم ورک میں سے ایک </a> ، صرف Starlette اور Uvicorn کے نیچے ( FASTAPI  کے ذریعہ اندرونی طور پر استعمال کیا جاتا ہے ) (*)
+
+لیکن جب بینچ مارک اور موازنہ کی جانچ پڑتال کرتے ہو تو آپ کو مندرجہ ذیل بات ذہن میں رکھنی چاہئے.
+
+## بینچ مارک اور رفتار
+
+جب آپ بینچ مارک کی جانچ کرتے ہیں تو ، مساوی کے مقابلے میں مختلف اقسام کے متعدد اوزار دیکھنا عام ہے.
+
+خاص طور پر ، Uvicorn, Starlette اور FastAPI کو دیکھنے کے لئے ( بہت سے دوسرے ٹولز ) کے ساتھ موازنہ کیا گیا.
+
+ٹول کے ذریعہ حل ہونے والا آسان مسئلہ ، اس کی بہتر کارکردگی ہوگی. اور زیادہ تر بینچ مارک ٹول کے ذریعہ فراہم کردہ اضافی خصوصیات کی جانچ نہیں کرتے ہیں.
+
+درجہ بندی کی طرح ہے:
+
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;">ASGI :<b>Uvicorn</b> سرور</div></li>
+    <ul>
+        <li><div style="text-align: right;"><b>Starlette</b>:  (Uvicorn استعمال کرتا ہے) ایک ویب مائیکرو فریم ورک </div></li>
+        <ul>
+            <li><div style="text-align: right;"><b>FastAPI</b>: (Starlette کا استعمال کرتا ہے) ایک API مائکرو فریم ورک جس میں APIs بنانے کے لیے کئی اضافی خصوصیات ہیں، ڈیٹا کی توثیق وغیرہ کے ساتھ۔</div></li>
+        </ul>
+    </ul>
+</ul>
+
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;"><b>Uvicorn</b>:</div></li>
+    <ul>
+        <li><div style="text-align: right;">بہترین کارکردگی ہوگی، کیونکہ اس میں سرور کے علاوہ زیادہ اضافی کوڈ نہیں ہے۔</div></li>
+        <li><div style="text-align: right;">آپ براہ راست Uvicorn میں درخواست نہیں لکھیں گے۔ اس کا مطلب یہ ہوگا کہ آپ کے کوڈ میں کم و بیش، کم از کم، Starlette (یا <b>FastAPI</b>) کی طرف سے فراہم کردہ تمام کوڈ شامل کرنا ہوں گے۔ اور اگر آپ نے ایسا کیا تو، آپ کی حتمی ایپلیکیشن کا وہی اوور ہیڈ ہوگا جیسا کہ ایک فریم ورک استعمال کرنے اور آپ کے ایپ کوڈ اور کیڑے کو کم سے کم کرنا۔</div></li>
+        <li><div style="text-align: right;">اگر آپ Uvicorn کا موازنہ کر رہے ہیں تو اس کا موازنہ Daphne، Hypercorn، uWSGI وغیرہ ایپلیکیشن سرورز سے کریں۔</div></li>
+    </ul>
+</ul>
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;"><b>Starlette</b>:</div></li>
+    <ul>
+        <li><div style="text-align: right;">Uvicorn کے بعد اگلی بہترین کارکردگی ہوگی۔ درحقیقت، Starlette چلانے کے لیے Uvicorn کا استعمال کرتی ہے۔ لہذا، یہ شاید زیادہ کوڈ پر عمل درآمد کرکے Uvicorn سے "سست" ہوسکتا ہے۔</div></li>
+        <li><div style="text-align: right;">لیکن یہ آپ کو آسان ویب ایپلیکیشنز بنانے کے لیے ٹولز فراہم کرتا ہے، راستوں پر مبنی روٹنگ کے ساتھ، وغیرہ۔</div></li>
+        <li><div style="text-align: right;">اگر آپ سٹارلیٹ کا موازنہ کر رہے ہیں تو اس کا موازنہ Sanic، Flask، Django وغیرہ سے کریں۔ ویب فریم ورکس (یا مائیکرو فریم ورکس)</div></li>
+    </ul>
+</ul>
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;"><b>FastAPI</b>:</div></li>
+    <ul>
+        <li><div style="text-align: right;">جس طرح سے Uvicorn Starlette کا استعمال کرتا ہے اور اس سے تیز نہیں ہو سکتا، Starlette <b>FastAPI</b> کا استعمال کرتا ہے، اس لیے یہ اس سے تیز نہیں ہو سکتا۔</div></li>
+        <li><div style="text-align: right;">Starlette FastAPI کے اوپری حصے میں مزید خصوصیات فراہم کرتا ہے۔ وہ خصوصیات جن کی آپ کو APIs بناتے وقت تقریباً ہمیشہ ضرورت ہوتی ہے، جیسے ڈیٹا کی توثیق اور سیریلائزیشن۔ اور اسے استعمال کرنے سے، آپ کو خودکار دستاویزات مفت میں مل جاتی ہیں (خودکار دستاویزات چلنے والی ایپلی کیشنز میں اوور ہیڈ کو بھی شامل نہیں کرتی ہیں، یہ اسٹارٹ اپ پر تیار ہوتی ہیں)۔</div></li>
+        <li><div style="text-align: right;">اگر آپ نے FastAPI کا استعمال نہیں کیا ہے اور Starlette کو براہ راست استعمال کیا ہے (یا کوئی دوسرا ٹول، جیسے Sanic، Flask، Responder، وغیرہ) آپ کو تمام ڈیٹا کی توثیق اور سیریلائزیشن کو خود نافذ کرنا ہوگا۔ لہذا، آپ کی حتمی ایپلیکیشن اب بھی وہی اوور ہیڈ ہوگی جیسا کہ اسے FastAPI کا استعمال کرتے ہوئے بنایا گیا تھا۔ اور بہت سے معاملات میں، یہ ڈیٹا کی توثیق اور سیریلائزیشن ایپلی کیشنز میں لکھے گئے کوڈ کی سب سے بڑی مقدار ہے۔</div></li>
+        <li><div style="text-align: right;">لہذا، FastAPI کا استعمال کرکے آپ ترقیاتی وقت، Bugs، کوڈ کی لائنوں کی بچت کر رہے ہیں، اور شاید آپ کو وہی کارکردگی (یا بہتر) ملے گی اگر آپ اسے استعمال نہیں کرتے (جیسا کہ آپ کو یہ سب اپنے کوڈ میں لاگو کرنا ہوگا۔ )</div></li>
+        <li><div style="text-align: right;">اگر آپ FastAPI کا موازنہ کر رہے ہیں، تو اس کا موازنہ ویب ایپلیکیشن فریم ورک (یا ٹولز کے سیٹ) سے کریں جو ڈیٹا کی توثیق، سیریلائزیشن اور دستاویزات فراہم کرتا ہے، جیسے Flask-apispec، NestJS، Molten، وغیرہ۔ مربوط خودکار ڈیٹا کی توثیق، سیریلائزیشن اور دستاویزات کے ساتھ فریم ورک۔</div></li>
+    </ul>
+</ul>
diff --git a/docs/ur/mkdocs.yml b/docs/ur/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/ur/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml
diff --git a/docs/vi/docs/features.md b/docs/vi/docs/features.md
new file mode 100644
index 000000000..306aeb359
--- /dev/null
+++ b/docs/vi/docs/features.md
@@ -0,0 +1,197 @@
+# Tính năng
+
+## Tính năng của FastAPI
+
+**FastAPI** cho bạn những tính năng sau:
+
+### Dựa trên những tiêu chuẩn mở
+
+* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> cho việc tạo API, bao gồm những khai báo về <abbr title="cũng được biết đến như: endpoints, routes">đường dẫn</abbr> <abbr title="cũng được biết đến như các phương thức HTTP, như POST, GET, PUT, DELETE"> các toán tử</abbr>, tham số, body requests, cơ chế bảo mật, etc.
+* Tự động tài liệu hóa data model theo <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON Schema</strong></a> (OpenAPI bản thân nó được dựa trên JSON Schema).
+* Được thiết kế xung quanh các tiêu chuẩn này sau khi nghiên cứu tỉ mỉ thay vì chỉ suy nghĩ đơn giản và sơ xài.
+* Điều này cho phép tự động hóa **trình sinh code client** cho nhiều ngôn ngữ lập trình khác nhau.
+
+### Tự động hóa tài liệu
+
+
+Tài liệu tương tác API và web giao diện người dùng. Là một framework được dựa trên OpenAPI do đó có nhiều tùy chọn giao diện cho tài liệu API, 2 giao diện bên dưới là mặc định.
+
+* <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank"><strong>Swagger UI</strong></a>, với giao diện khám phá, gọi và kiểm thử API trực tiếp từ trình duyệt.
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Thay thế với tài liệu API với <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank"><strong>ReDoc</strong></a>.
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Chỉ cần phiên bản Python hiện đại
+
+Tất cả được dựa trên khai báo kiểu dữ liệu chuẩn của **Python 3.8** (cảm ơn Pydantic). Bạn không cần học cú pháp mới, chỉ cần biết chuẩn Python hiện đại.
+
+Nếu bạn cần 2 phút để làm mới lại cách sử dụng các kiểu dữ liệu mới của Python (thậm chí nếu bạn không sử dụng FastAPI), xem hướng dẫn ngắn: [Kiểu dữ liệu Python](python-types.md){.internal-link target=_blank}.
+
+Bạn viết chuẩn Python với kiểu dữ liệu như sau:
+
+```Python
+from datetime import date
+
+from pydantic import BaseModel
+
+# Declare a variable as a str
+# and get editor support inside the function
+def main(user_id: str):
+    return user_id
+
+
+# A Pydantic model
+class User(BaseModel):
+    id: int
+    name: str
+    joined: date
+```
+
+Sau đó có thể được sử dụng:
+
+```Python
+my_user: User = User(id=3, name="John Doe", joined="2018-07-19")
+
+second_user_data = {
+    "id": 4,
+    "name": "Mary",
+    "joined": "2018-11-30",
+}
+
+my_second_user: User = User(**second_user_data)
+```
+
+!!! info
+    `**second_user_data` nghĩa là:
+
+    Truyền các khóa và giá trị của dict `second_user_data` trực tiếp như các tham số kiểu key-value, tương đương với: `User(id=4, name="Mary", joined="2018-11-30")`
+
+### Được hỗ trợ từ các trình soạn thảo
+
+
+Toàn bộ framework được thiết kế để sử dụng dễ dàng và trực quan, toàn bộ quyết định đã được kiểm thử trên nhiều trình soạn thảo thậm chí trước khi bắt đầu quá trình phát triển, để chắc chắn trải nghiệm phát triển là tốt nhất.
+
+Trong lần khảo sát cuối cùng dành cho các lập trình viên Python, đã rõ ràng <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">rằng đa số các lập trình viên sử dụng tính năng "autocompletion"</a>.
+
+Toàn bộ framework "FastAPI" phải đảm bảo rằng: autocompletion hoạt động ở mọi nơi. Bạn sẽ hiếm khi cần quay lại để đọc tài liệu.
+
+Đây là các trình soạn thảo có thể giúp bạn:
+
+* trong <a href="https://code.visualstudio.com/" class="external-link" target="_blank">Visual Studio Code</a>:
+
+![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+* trong <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a>:
+
+![editor support](https://fastapi.tiangolo.com/img/pycharm-completion.png)
+
+Bạn sẽ có được auto-completion trong code, thậm chí trước đó là không thể. Như trong ví dụ, khóa `price` bên trong một JSON (đó có thể được lồng nhau) đến từ một request.
+
+Không còn nhập sai tên khóa, quay đi quay lại giữa các tài liệu hoặc cuộn lên cuộn xuống để tìm xem cuối cùng bạn đã sử dụng `username` hay `user_name`.
+
+### Ngắn gọn
+
+FastAPI có các giá trị mặc định hợp lý cho mọi thứ, với các cấu hình tùy chọn ở mọi nơi. Tất cả các tham số có thể được tinh chỉnh để thực hiện những gì bạn cần và để định nghĩa API bạn cần.
+
+Nhưng mặc định, tất cả **đều hoạt động**.
+
+### Validation
+
+* Validation cho đa số (hoặc tất cả?) **các kiểu dữ liệu** Python, bao gồm:
+    * JSON objects (`dict`).
+    * Mảng JSON (`list`) định nghĩa kiểu dữ liệu từng phần tử.
+    * Xâu (`str`), định nghĩa độ dài lớn nhất, nhỏ nhất.
+    * Số (`int`, `float`) với các giá trị lớn nhất, nhỏ nhất, etc.
+
+* Validation cho nhiều kiểu dữ liệu bên ngoài như:
+    * URL.
+    * Email.
+    * UUID.
+    * ...và nhiều cái khác.
+
+Tất cả validation được xử lí bằng những thiết lập tốt và mạnh mẽ của **Pydantic**.
+
+### Bảo mật và xác thực
+
+Bảo mật và xác thực đã tích hợp mà không làm tổn hại tới cơ sở dữ liệu hoặc data models.
+
+Tất cả cơ chế bảo mật định nghĩa trong OpenAPI, bao gồm:
+
+* HTTP Basic.
+* **OAuth2** (với **JWT tokens**). Xem hướng dẫn [OAuth2 with JWT](tutorial/security/oauth2-jwt.md){.internal-link target=_blank}.
+* API keys in:
+    * Headers.
+    * Các tham số trong query string.
+    * Cookies, etc.
+
+Cộng với tất cả các tính năng bảo mật từ Starlette (bao gồm **session cookies**).
+
+Tất cả được xây dựng dưới dạng các công cụ và thành phần có thể tái sử dụng, dễ dàng tích hợp với hệ thống, kho lưu trữ dữ liệu, cơ sở dữ liệu quan hệ và NoSQL của bạn,...
+
+### Dependency Injection
+
+FastAPI bao gồm một hệ thống <abbr title='cũng biết đến như là "components", "resources", "services", "providers"'><strong>Dependency Injection</strong></abbr> vô cùng dễ sử dụng nhưng vô cùng mạnh mẽ.
+
+* Thậm chí, các dependency có thể có các dependency khác, tạo thành một phân cấp hoặc **"một đồ thị" của các dependency**.
+* Tất cả **được xử lí tự động** bởi framework.
+* Tất cả các dependency có thể yêu cầu dữ liệu từ request và **tăng cường các ràng buộc từ đường dẫn** và tự động tài liệu hóa.
+* **Tự động hóa validation**, thậm chí với các tham số *đường dẫn* định nghĩa trong các dependency.
+* Hỗ trợ hệ thống xác thực người dùng phức tạp, **các kết nối cơ sở dữ liệu**,...
+* **Không làm tổn hại** cơ sở dữ liệu, frontends,... Nhưng dễ dàng tích hợp với tất cả chúng.
+
+### Không giới hạn "plug-ins"
+
+Hoặc theo một cách nào khác, không cần chúng, import và sử dụng code bạn cần.
+
+Bất kì tích hợp nào được thiết kế để sử dụng đơn giản (với các dependency), đến nỗi bạn có thể tạo một "plug-in" cho ứng dụng của mình trong 2 dòng code bằng cách sử dụng cùng một cấu trúc và cú pháp được sử dụng cho *path operations* của bạn.
+
+### Đã được kiểm thử
+
+* 100% <abbr title=" Lượng code đã được kiểm thử tự động">test coverage</abbr>.
+* 100% <abbr title="Python type annotations, với điều này trình soạn thảo của bạn và các công cụ bên ngoài có thể hỗ trợ bạn tốt hơn">type annotated</abbr> code base.
+* Được sử dụng cho các ứng dụng sản phẩm.
+
+## Tính năng của Starlette
+
+`FastAPI` is thực sự là một sub-class của `Starlette`. Do đó, nếu bạn đã biết hoặc đã sử dụng Starlette, đa số các chức năng sẽ làm việc giống như vậy.
+
+Với **FastAPI**, bạn có được tất cả những tính năng của **Starlette**:
+
+* Hiệu năng thực sự ấn tượng. Nó là <a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">một trong nhưng framework Python nhanh nhất, khi so sánh với **NodeJS** và **Go**</a>.
+* Hỗ trợ **WebSocket**.
+* In-process background tasks.
+* Startup and shutdown events.
+* Client cho kiểm thử xây dựng trên HTTPX.
+* **CORS**, GZip, Static Files, Streaming responses.
+* Hỗ trợ **Session and Cookie**.
+* 100% test coverage.
+* 100% type annotated codebase.
+
+## Tính năng của Pydantic
+
+**FastAPI** tương thích đầy đủ với (và dựa trên) <a href="https://pydantic-docs.helpmanual.io" class="external-link" target="_blank"><strong>Pydantic</strong></a>. Do đó, bất kì code Pydantic nào bạn thêm vào cũng sẽ hoạt động.
+
+Bao gồm các thư viện bên ngoài cũng dựa trên Pydantic, như <abbr title="Object-Relational Mapper">ORM</abbr>s, <abbr title="Object-Document Mapper">ODM</abbr>s cho cơ sở dữ liệu.
+
+Nó cũng có nghĩa là trong nhiều trường hợp, bạn có thể truyền cùng object bạn có từ một request **trực tiếp cho cơ sở dữ liệu**, vì mọi thứ được validate tự động.
+
+Điều tương tự áp dụng cho các cách khác nhau, trong nhiều trường hợp, bạn có thể chỉ truyền object từ cơ sở dữ liêu **trực tiếp tới client**.
+
+Với **FastAPI**, bạn có tất cả những tính năng của **Pydantic** (FastAPI dựa trên Pydantic cho tất cả những xử lí về dữ liệu):
+
+* **Không gây rối não**:
+    * Không cần học ngôn ngữ mô tả cấu trúc mới.
+    * Nếu bạn biết kiểu dữ liệu Python, bạn biết cách sử dụng Pydantic.
+* Sử dụng tốt với **<abbr title="Môi trường phát triển tích hợp, tương tự như một trình soạn thảo code">IDE</abbr>/<abbr title="Một chương trình kiểm tra code lỗi">linter</abbr>/não của bạn**:
+
+    * Bởi vì các cấu trúc dữ liệu của Pydantic chỉ là các instances của class bạn định nghĩa; auto-completion, linting, mypy và trực giác của bạn nên làm việc riêng biệt với những dữ liệu mà bạn đã validate.
+* Validate **các cấu trúc phức tạp**:
+    * Sử dụng các models Pydantic phân tầng, `List` và `Dict` của Python `typing`,...
+    * Và các validators cho phép các cấu trúc dữ liệu phức tạp trở nên rõ ràng và dễ dàng để định nghĩa, kiểm tra và tài liệu hóa thành JSON Schema.
+    * Bạn có thể có các object **JSON lồng nhau** và tất cả chúng đã validate và annotated.
+* **Có khả năng mở rộng**:
+    * Pydantic cho phép bạn tùy chỉnh kiểu dữ liệu bằng việc định nghĩa hoặc bạn có thể mở rộng validation với các decorator trong model.
+* 100% test coverage.
diff --git a/docs/vi/docs/index.md b/docs/vi/docs/index.md
new file mode 100644
index 000000000..3f416dbec
--- /dev/null
+++ b/docs/vi/docs/index.md
@@ -0,0 +1,472 @@
+<p align="center">
+  <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
+</p>
+<p align="center">
+    <em>FastAPI framework, hiệu năng cao, dễ học, dễ code, sẵn sàng để tạo ra sản phẩm</em>
+</p>
+<p align="center">
+<a href="https://github.com/tiangolo/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" target="_blank">
+    <img src="https://github.com/tiangolo/fastapi/workflows/Test/badge.svg?event=push&branch=master" alt="Test">
+</a>
+<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/tiangolo/fastapi" target="_blank">
+    <img src="https://coverage-badge.samuelcolvin.workers.dev/tiangolo/fastapi.svg" alt="Coverage">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/v/fastapi?color=%2334D058&label=pypi%20package" alt="Package version">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions">
+</a>
+</p>
+
+---
+
+**Tài liệu**: <a href="https://fastapi.tiangolo.com" target="_blank">https://fastapi.tiangolo.com</a>
+
+**Mã nguồn**: <a href="https://github.com/tiangolo/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
+
+---
+
+FastAPI là một web framework hiện đại, hiệu năng cao để xây dựng web APIs với Python 3.8+ dựa trên tiêu chuẩn Python type hints.
+
+Những tính năng như:
+
+* **Nhanh**: Hiệu năng rất cao khi so sánh với **NodeJS** và **Go** (cảm ơn Starlette và Pydantic). [Một trong những Python framework nhanh nhất](#performance).
+* **Code nhanh**: Tăng tốc độ phát triển tính năng từ 200% tới 300%. *
+* **Ít lỗi hơn**: Giảm khoảng 40% những lỗi phát sinh bởi con người (nhà phát triển). *
+* **Trực giác tốt hơn**: Được các trình soạn thảo hỗ tuyệt vời. <abbr title="như auto-complete, autocompletion, IntelliSense">Completion</abbr> mọi nơi. Ít thời gian gỡ lỗi.
+* **Dễ dàng**: Được thiết kế để dễ dàng học và sử dụng. Ít thời gian đọc tài liệu.
+* **Ngắn**: Tối thiểu code bị trùng lặp. Nhiều tính năng được tích hợp khi định nghĩa tham số. Ít lỗi hơn.
+* **Tăng tốc**: Có được sản phẩm cùng với tài liệu (được tự động tạo) có thể tương tác.
+* **Được dựa trên các tiêu chuẩn**: Dựa trên (và hoàn toàn tương thích với) các tiêu chuẩn mở cho APIs : <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> (trước đó được biết đến là Swagger) và <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>.
+
+<small>* ước tính được dựa trên những kiểm chứng trong nhóm phát triển nội bộ, xây dựng các ứng dụng sản phẩm.</small>
+
+## Nhà tài trợ
+
+<!-- sponsors -->
+
+{% if sponsors %}
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor -%}
+{%- for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+<!-- /sponsors -->
+
+<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Những nhà tài trợ khác</a>
+
+## Ý kiến đánh giá
+
+"_[...] Tôi đang sử dụng **FastAPI** vô cùng nhiều vào những ngày này. [...] Tôi thực sự đang lên kế hoạch sử dụng nó cho tất cả các nhóm **dịch vụ ML tại Microsoft**. Một vài trong số đó đang tích hợp vào sản phẩm lõi của **Window** và một vài sản phẩm cho **Office**._"
+
+<div style="text-align: right; margin-right: 10%;">Kabir Khan - <strong>Microsoft</strong> <a href="https://github.com/tiangolo/fastapi/pull/26" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Chúng tôi tích hợp thư viện **FastAPI** để sinh ra một **REST** server, nó có thể được truy vấn để thu được những **dự đoán**._ [bởi Ludwid] "
+
+<div style="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin, và Sai Sumanth Miryala - <strong>Uber</strong> <a href="https://eng.uber.com/ludwig-v0-2/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_**Netflix** vui mừng thông báo việc phát hành framework mã nguồn mở của chúng tôi cho *quản lí khủng hoảng* tập trung: **Dispatch**! [xây dựng với **FastAPI**]_"
+
+<div style="text-align: right; margin-right: 10%;">Kevin Glisson, Marc Vilanova, Forest Monsen - <strong>Netflix</strong> <a href="https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Tôi vô cùng hào hứng về **FastAPI**. Nó rất thú vị_"
+
+<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">Python Bytes</a> podcast host</strong> <a href="https://twitter.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Thành thật, những gì bạn đã xây dựng nhìn siêu chắc chắn và bóng bẩy. Theo nhiều cách, nó là những gì tôi đã muốn Hug trở thành - thật sự truyền cảm hứng để thấy ai đó xây dựng nó._"
+
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - người tạo ra <strong><a href="https://www.hug.rest/" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Nếu bạn đang tìm kiếm một **framework hiện đại** để xây dựng một REST APIs, thử xem xét **FastAPI** [...] Nó nhanh, dễ dùng và dễ học [...]_"
+
+"_Chúng tôi đã chuyển qua **FastAPI cho **APIs** của chúng tôi [...] Tôi nghĩ bạn sẽ thích nó [...]_"
+
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong><a href="https://explosion.ai" target="_blank">Explosion AI</a> founders - <a href="https://spacy.io" target="_blank">spaCy</a> creators</strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong>nhà sáng lập <a href="https://explosion.ai" target="_blank">Explosion AI</a> - người tạo ra <a href="https://spacy.io" target="_blank">spaCy</a></strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Nếu ai đó đang tìm cách xây dựng sản phẩm API bằng Python, tôi sẽ đề xuất **FastAPI**. Nó **được thiết kế đẹp đẽ**, **sử dụng đơn giản** và **có khả năng mở rộng cao**, nó đã trở thành một **thành phần quan trọng** trong chiến lược phát triển API của chúng tôi và đang thúc đẩy nhiều dịch vụ và mảng tự động hóa như Kỹ sư TAC ảo của chúng tôi._"
+
+<div style="text-align: right; margin-right: 10%;">Deon Pillsbury - <strong>Cisco</strong> <a href="https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+## **Typer**, giao diện dòng lệnh của FastAPI
+
+<a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
+
+Nếu bạn đang xây dựng một <abbr title="Giao diện dòng lệnh">CLI</abbr> - ứng dụng được sử dụng trong giao diện dòng lệnh, xem về <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>.
+
+**Typer** là một người anh em của FastAPI. Và nó được dự định trở thành **giao diện dòng lệnh cho FastAPI**. ⌨️ 🚀
+
+## Yêu cầu
+
+Python 3.8+
+
+FastAPI đứng trên vai những người khổng lồ:
+
+* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> cho phần web.
+* <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> cho phần data.
+
+## Cài đặt
+
+<div class="termy">
+
+```console
+$ pip install fastapi
+
+---> 100%
+```
+
+</div>
+
+Bạn cũng sẽ cần một ASGI server cho production như <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a> hoặc <a href="https://github.com/pgjones/hypercorn" class="external-link" target="_blank">Hypercorn</a>.
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]"
+
+---> 100%
+```
+
+</div>
+
+## Ví dụ
+
+### Khởi tạo
+
+* Tạo một tệp tin `main.py` như sau:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+<details markdown="1">
+<summary>Hoặc sử dụng <code>async def</code>...</summary>
+
+Nếu code của bạn sử dụng `async` / `await`, hãy sử dụng `async def`:
+
+```Python hl_lines="9  14"
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+async def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+**Lưu ý**:
+
+Nếu bạn không biết, xem phần _"In a hurry?"_ về <a href="https://fastapi.tiangolo.com/async/#in-a-hurry" target="_blank">`async` và `await` trong tài liệu này</a>.
+
+</details>
+
+### Chạy ứng dụng
+
+Chạy server như sau:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+INFO:     Started reloader process [28720]
+INFO:     Started server process [28722]
+INFO:     Waiting for application startup.
+INFO:     Application startup complete.
+```
+
+</div>
+
+<details markdown="1">
+<summary>Về lệnh <code>uvicorn main:app --reload</code>...</summary>
+
+Lệnh `uvicorn main:app` tham chiếu tới những thành phần sau:
+
+* `main`: tệp tin `main.py` (một Python "module").
+* `app`: object được tạo trong tệp tin `main.py` tại dòng `app = FastAPI()`.
+* `--reload`: chạy lại server sau khi code thay đổi. Chỉ sử dụng trong quá trình phát triển.
+
+</details>
+
+### Kiểm tra
+
+Mở trình duyệt của bạn tại <a href="http://127.0.0.1:8000/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
+
+Bạn sẽ thấy một JSON response:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+Bạn đã sẵn sàng để tạo một API như sau:
+
+* Nhận HTTP request với _đường dẫn_ `/` và `/items/{item_id}`.
+* Cả hai _đường dẫn_ sử dụng <em>toán tử</em> `GET` (cũng đươc biết đến là _phương thức_ HTTP).
+* _Đường dẫn_ `/items/{item_id}` có một _tham số đường dẫn_ `item_id`, nó là một tham số kiểu `int`.
+* _Đường dẫn_ `/items/{item_id}`  có một _tham số query string_ `q`, nó là một tham số tùy chọn kiểu `str`.
+
+### Tài liệu tương tác API
+
+Truy cập <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Bạn sẽ thấy tài liệu tương tác API được tạo tự động (cung cấp bởi <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Tài liệu API thay thế
+
+Và bây giờ, hãy truy cập tới <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Bạn sẽ thấy tài liệu được thay thế (cung cấp bởi <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Nâng cấp ví dụ
+
+Bây giờ sửa tệp tin `main.py` để nhận body từ một request `PUT`.
+
+Định nghĩa của body sử dụng kiểu dữ liệu chuẩn của Python, cảm ơn Pydantic.
+
+```Python hl_lines="4  9-12  25-27"
+from typing import Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    price: float
+    is_offer: Union[bool, None] = None
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+
+
+@app.put("/items/{item_id}")
+def update_item(item_id: int, item: Item):
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+Server nên tự động chạy lại (bởi vì bạn đã thêm `--reload` trong lệnh `uvicorn` ở trên).
+
+### Nâng cấp tài liệu API
+
+Bây giờ truy cập tới <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+* Tài liệu API sẽ được tự động cập nhật, bao gồm body mới:
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Click vào nút "Try it out", nó cho phép bạn điền những tham số và tương tác trực tiếp với API:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-04-swagger-03.png)
+
+* Sau khi click vào nút "Execute", giao diện người dùng sẽ giao tiếp với API của bạn bao gồm: gửi các tham số, lấy kết quả và hiển thị chúng trên màn hình:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png)
+
+### Nâng cấp tài liệu API thay thế
+
+Và bây giờ truy cập tới <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+* Tài liệu thay thế cũng sẽ phản ánh tham số và body mới:
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Tóm lại
+
+Bạn khai báo **một lần** kiểu dữ liệu của các tham số, body, etc là các tham số của hàm số.
+
+Bạn định nghĩa bằng cách sử dụng các kiểu dữ liệu chuẩn của Python.
+
+Bạn không phải học một cú pháp mới, các phương thức và class của một thư viện cụ thể nào.
+
+Chỉ cần sử dụng các chuẩn của **Python 3.8+**.
+
+Ví dụ, với một tham số kiểu `int`:
+
+```Python
+item_id: int
+```
+
+hoặc với một model `Item` phức tạp hơn:
+
+```Python
+item: Item
+```
+
+...và với định nghĩa đơn giản đó, bạn có được:
+
+* Sự hỗ trợ từ các trình soạn thảo, bao gồm:
+    * Completion.
+    * Kiểm tra kiểu dữ liệu.
+* Kiểm tra kiểu dữ liệu:
+    * Tự động sinh lỗi rõ ràng khi dữ liệu không hợp lệ .
+    * Kiểm tra JSON lồng nhau .
+* <abbr title="cũng được biết tới như: serialization, parsing, marshalling">Chuyển đổi</abbr> dữ liệu đầu vào: tới từ network sang dữ liệu kiểu Python. Đọc từ:
+    * JSON.
+    * Các tham số trong đường dẫn.
+    * Các tham số trong query string.
+    * Cookies.
+    * Headers.
+    * Forms.
+    * Files.
+* <abbr title="cũng được biết tới như: serialization, parsing, marshalling">Chuyển đổi</abbr> dữ liệu đầu ra: chuyển đổi từ kiểu dữ liệu Python sang dữ liệu network (như JSON):
+    * Chuyển đổi kiểu dữ liệu Python (`str`, `int`, `float`, `bool`, `list`,...).
+    * `datetime` objects.
+    * `UUID` objects.
+    * Database models.
+    * ...và nhiều hơn thế.
+* Tự động tạo tài liệu tương tác API, bao gồm 2 giao diện người dùng:
+    * Swagger UI.
+    * ReDoc.
+
+---
+
+Quay trở lại ví dụ trước, **FastAPI** sẽ thực hiện:
+
+* Kiểm tra xem có một `item_id` trong đường dẫn với các request `GET` và `PUT` không?
+* Kiểm tra xem `item_id` có phải là kiểu `int` trong các request `GET` và `PUT` không?
+    * Nếu không, client sẽ thấy một lỗi rõ ràng và hữu ích.
+* Kiểm tra xem nếu có một tham số `q` trong query string (ví dụ như `http://127.0.0.1:8000/items/foo?q=somequery`) cho request `GET`.
+    * Tham số `q` được định nghĩa `= None`, nó là tùy chọn.
+    * Nếu không phải `None`, nó là bắt buộc (như body trong trường hợp của `PUT`).
+* Với request `PUT` tới `/items/{item_id}`, đọc body như JSON:
+    * Kiểm tra xem nó có một thuộc tính bắt buộc kiểu  `str` là `name` không?
+    * Kiểm tra xem nó có một thuộc tính bắt buộc kiểu `float` là `price` không?
+    * Kiểm tra xem nó có một thuộc tính tùy chọn là `is_offer` không? Nếu có, nó phải có kiểu `bool`.
+    * Tất cả những kiểm tra này cũng được áp dụng với các JSON lồng nhau.
+* Chuyển đổi tự động các JSON object đến và JSON object đi.
+* Tài liệu hóa mọi thứ với OpenAPI, tài liệu đó có thể được sử dụng bởi:
+
+    * Các hệ thống tài liệu có thể tương tác.
+    * Hệ thống sinh code tự động, cho nhiều ngôn ngữ lập trình.
+* Cung cấp trực tiếp 2 giao diện web cho tài liệu tương tác
+
+---
+
+Chúng tôi chỉ trình bày những thứ cơ bản bên ngoài, nhưng bạn đã hiểu cách thức hoạt động của nó.
+
+Thử thay đổi dòng này:
+
+```Python
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+...từ:
+
+```Python
+        ... "item_name": item.name ...
+```
+
+...sang:
+
+```Python
+        ... "item_price": item.price ...
+```
+
+...và thấy trình soạn thảo của bạn nhận biết kiểu dữ liệu và gợi ý hoàn thiện các thuộc tính.
+
+![trình soạn thảo hỗ trợ](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+Ví dụ hoàn chỉnh bao gồm nhiều tính năng hơn, xem <a href="https://fastapi.tiangolo.com/tutorial/">Tutorial - User Guide</a>.
+
+
+**Cảnh báo tiết lỗ**: Tutorial - User Guide:
+
+* Định nghĩa **tham số** từ các nguồn khác nhau như: **headers**, **cookies**, **form fields** và **files**.
+* Cách thiết lập **các ràng buộc cho validation** như `maximum_length` hoặc `regex`.
+* Một hệ thống **<abbr title="cũng được biết đến như components, resources, providers, services, injectables">Dependency Injection</abbr> vô cùng mạnh mẽ và dễ dàng sử dụng.
+* Bảo mật và xác thực, hỗ trợ **OAuth2**(với **JWT tokens**) và **HTTP Basic**.
+* Những kĩ thuật nâng cao hơn (nhưng tương đối dễ) để định nghĩa **JSON models lồng nhau** (cảm ơn Pydantic).
+* Tích hợp **GraphQL** với <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> và các thư viện khác.
+* Nhiều tính năng mở rộng (cảm ơn Starlette) như:
+    * **WebSockets**
+    * kiểm thử vô cùng dễ dàng dựa trên HTTPX và `pytest`
+    * **CORS**
+    * **Cookie Sessions**
+    * ...và nhiều hơn thế.
+
+## Hiệu năng
+
+Independent TechEmpower benchmarks cho thấy các ứng dụng **FastAPI** chạy dưới Uvicorn là <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">một trong những Python framework nhanh nhất</a>, chỉ đứng sau Starlette và Uvicorn (được sử dụng bên trong FastAPI). (*)
+
+Để hiểu rõ hơn, xem phần <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Benchmarks</a>.
+
+## Các dependency tùy chọn
+
+Sử dụng bởi Pydantic:
+
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - <abbr title="chuyển dổi string từ HTTP request sang dữ liệu Python">"Parse"</abbr> JSON nhanh hơn.
+* <a href="https://github.com/JoshData/python-email-validator" target="_blank"><code>email_validator</code></a> - cho email validation.
+
+Sử dụng Starlette:
+
+* <a href="https://www.python-httpx.org" target="_blank"><code>httpx</code></a> - Bắt buộc nếu bạn muốn sử dụng `TestClient`.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Bắt buộc nếu bạn muốn sử dụng cấu hình template engine mặc định.
+* <a href="https://andrew-d.github.io/python-multipart/" target="_blank"><code>python-multipart</code></a> - Bắt buộc nếu bạn muốn hỗ trợ <abbr title="converting the string that comes from an HTTP request into Python data">"parsing"</abbr>, form với `request.form()`.
+* <a href="https://pythonhosted.org/itsdangerous/" target="_blank"><code>itsdangerous</code></a> - Bắt buộc để hỗ trợ `SessionMiddleware`.
+* <a href="https://pyyaml.org/wiki/PyYAMLDocumentation" target="_blank"><code>pyyaml</code></a> - Bắt buộc để hỗ trợ `SchemaGenerator` cho Starlette (bạn có thể không cần nó trong FastAPI).
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - Bắt buộc nếu bạn muốn sử dụng `UJSONResponse`.
+
+Sử dụng bởi FastAPI / Starlette:
+
+* <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - Server để chạy ứng dụng của bạn.
+* <a href="https://github.com/ijl/orjson" target="_blank"><code>orjson</code></a> - Bắt buộc nếu bạn muốn sử dụng `ORJSONResponse`.
+
+Bạn có thể cài đặt tất cả những dependency trên với `pip install "fastapi[all]"`.
+
+## Giấy phép
+
+Dự án này được cấp phép dưới những điều lệ của giấy phép MIT.
diff --git a/docs/vi/docs/python-types.md b/docs/vi/docs/python-types.md
new file mode 100644
index 000000000..4999caac3
--- /dev/null
+++ b/docs/vi/docs/python-types.md
@@ -0,0 +1,545 @@
+# Giới thiệu kiểu dữ liệu Python
+
+Python hỗ trợ tùy chọn "type hints" (còn được gọi là "type annotations").
+
+Những **"type hints"** hay chú thích là một cú pháp đặc biệt cho phép khai báo <abbr title="ví dụ: str, int, float, bool"> kiểu dữ liệu</abbr> của một biến.
+
+Bằng việc khai báo kiểu dữ liệu cho các biến của bạn, các trình soạn thảo và các công cụ có thể hỗ trợ bạn tốt hơn.
+
+Đây chỉ là một **hướng dẫn nhanh** về gợi ý kiểu dữ liệu trong Python. Nó chỉ bao gồm những điều cần thiết tối thiểu để sử dụng chúng với **FastAPI**... đó thực sự là rất ít.
+
+**FastAPI** hoàn toàn được dựa trên những gợi ý kiểu dữ liệu, chúng mang đến nhiều ưu điểm và lợi ích.
+
+Nhưng thậm chí nếu bạn không bao giờ sử dụng **FastAPI**, bạn sẽ được lợi từ việc học một ít về chúng.
+
+!!! note
+    Nếu bạn là một chuyên gia về Python, và bạn đã biết mọi thứ về gợi ý kiểu dữ liệu, bỏ qua và đi tới chương tiếp theo.
+
+## Động lực
+
+Hãy bắt đầu với một ví dụ đơn giản:
+
+```Python
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+Kết quả khi gọi chương trình này:
+
+```
+John Doe
+```
+
+Hàm thực hiện như sau:
+
+* Lấy một `first_name` và `last_name`.
+* Chuyển đổi kí tự đầu tiên của mỗi biến sang kiểu chữ hoa với `title()`.
+* <abbr title="Đặt chúng lại với nhau thành một. Với các nội dung lần lượt.">Nối</abbr> chúng lại với nhau bằng một kí tự trắng ở giữa.
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+### Sửa đổi
+
+Nó là một chương trình rất đơn giản.
+
+Nhưng bây giờ hình dung rằng bạn đang viết nó từ đầu.
+
+Tại một vài thời điểm, bạn sẽ bắt đầu định nghĩa hàm, bạn có các tham số...
+
+Nhưng sau đó bạn phải gọi "phương thức chuyển đổi kí tự đầu tiên sang kiểu chữ hoa".
+
+Có phải là `upper`? Có phải là `uppercase`? `first_uppercase`? `capitalize`?
+
+Sau đó, bạn thử hỏi người bạn cũ của mình, autocompletion của trình soạn thảo.
+
+Bạn gõ tham số đầu tiên của hàm, `first_name`, sau đó một dấu chấm (`.`) và sau đó ấn `Ctrl+Space` để kích hoạt bộ hoàn thành.
+
+Nhưng đáng buồn, bạn không nhận được điều gì hữu ích cả:
+
+<img src="/img/python-types/image01.png">
+
+### Thêm kiểu dữ liệu
+
+Hãy sửa một dòng từ phiên bản trước.
+
+Chúng ta sẽ thay đổi chính xác đoạn này, tham số của hàm, từ:
+
+```Python
+    first_name, last_name
+```
+
+sang:
+
+```Python
+    first_name: str, last_name: str
+```
+
+Chính là nó.
+
+Những thứ đó là "type hints":
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial002.py!}
+```
+
+Đó không giống như khai báo những giá trị mặc định giống như:
+
+```Python
+    first_name="john", last_name="doe"
+```
+
+Nó là một thứ khác.
+
+Chúng ta sử dụng dấu hai chấm (`:`), không phải dấu bằng (`=`).
+
+Và việc thêm gợi ý kiểu dữ liệu không làm thay đổi những gì xảy ra so với khi chưa thêm chúng.
+
+But now, imagine you are again in the middle of creating that function, but with type hints.
+
+Tại cùng một điểm, bạn thử kích hoạt autocomplete với `Ctrl+Space` và bạn thấy:
+
+<img src="/img/python-types/image02.png">
+
+Với cái đó, bạn có thể cuộn, nhìn thấy các lựa chọn, cho đến khi bạn tìm thấy một "tiếng chuông":
+
+<img src="/img/python-types/image03.png">
+
+## Động lực nhiều hơn
+
+Kiểm tra hàm này, nó đã có gợi ý kiểu dữ liệu:
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial003.py!}
+```
+
+Bởi vì trình soạn thảo biết kiểu dữ liệu của các biến, bạn không chỉ có được completion, bạn cũng được kiểm tra lỗi:
+
+<img src="/img/python-types/image04.png">
+
+Bây giờ bạn biết rằng bạn phải sửa nó, chuyển `age` sang một xâu với `str(age)`:
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial004.py!}
+```
+
+## Khai báo các kiểu dữ liệu
+
+Bạn mới chỉ nhìn thấy những nơi chủ yếu để đặt khai báo kiểu dữ liệu. Như là các tham số của hàm.
+
+Đây cũng là nơi chủ yếu để bạn sử dụng chúng với **FastAPI**.
+
+### Kiểu dữ liệu đơn giản
+
+Bạn có thể khai báo tất cả các kiểu dữ liệu chuẩn của Python, không chỉ là `str`.
+
+Bạn có thể sử dụng, ví dụ:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial005.py!}
+```
+
+### Các kiểu dữ liệu tổng quát với tham số kiểu dữ liệu
+
+Có một vài cấu trúc dữ liệu có thể chứa các giá trị khác nhau như `dict`, `list`, `set` và `tuple`. Và những giá trị nội tại cũng có thể có kiểu dữ liệu của chúng.
+
+Những kiểu dữ liệu nội bộ này được gọi là những kiểu dữ liệu "**tổng quát**". Và có khả năng khai báo chúng, thậm chí với các kiểu dữ liệu nội bộ của chúng.
+
+Để khai báo những kiểu dữ liệu và những kiểu dữ liệu nội bộ đó, bạn có thể sử dụng mô đun chuẩn của Python là `typing`. Nó có hỗ trợ những gợi ý kiểu dữ liệu này.
+
+#### Những phiên bản mới hơn của Python
+
+Cú pháp sử dụng `typing` **tương thích** với tất cả các phiên bản, từ Python 3.6 tới những phiên bản cuối cùng, bao gồm Python 3.9, Python 3.10,...
+
+As Python advances, **những phiên bản mới** mang tới sự hỗ trợ được cải tiến cho những chú thích kiểu dữ liệu và trong nhiều trường hợp bạn thậm chí sẽ không cần import và sử dụng mô đun `typing` để khai báo chú thích kiểu dữ liệu.
+
+Nếu bạn có thể chọn một phiên bản Python gần đây hơn cho dự án của bạn, ban sẽ có được những ưu điểm của những cải tiến đơn giản đó.
+
+Trong tất cả các tài liệu tồn tại những ví dụ tương thích với mỗi phiên bản Python (khi có một sự khác nhau).
+
+Cho ví dụ "**Python 3.6+**" có nghĩa là nó tương thích với Python 3.7 hoặc lớn hơn (bao gồm 3.7, 3.8, 3.9, 3.10,...). và "**Python 3.9+**" nghĩa là nó tương thích với Python 3.9 trở lên (bao gồm 3.10,...).
+
+Nếu bạn có thể sử dụng **phiên bản cuối cùng của Python**, sử dụng những ví dụ cho phiên bản cuối, những cái đó sẽ có **cú pháp đơn giản và tốt nhât**, ví dụ, "**Python 3.10+**".
+
+#### List
+
+Ví dụ, hãy định nghĩa một biến là `list` các `str`.
+
+=== "Python 3.9+"
+
+    Khai báo biến với cùng dấu hai chấm (`:`).
+
+    Tương tự kiểu dữ liệu `list`.
+
+    Như danh sách là một kiểu dữ liệu chứa một vài kiểu dữ liệu có sẵn, bạn đặt chúng trong các dấu ngoặc vuông:
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    Từ `typing`, import `List` (với chữ cái `L` viết hoa):
+
+    ``` Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+    Khai báo biến với cùng dấu hai chấm (`:`).
+
+    Tương tự như kiểu dữ liệu, `List` bạn import từ `typing`.
+
+    Như danh sách là một kiểu dữ liệu chứa các kiểu dữ liệu có sẵn, bạn đặt chúng bên trong dấu ngoặc vuông:
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+!!! info
+    Các kiểu dữ liệu có sẵn bên trong dấu ngoặc vuông được gọi là "tham số kiểu dữ liệu".
+
+    Trong trường hợp này, `str` là tham số kiểu dữ liệu được truyền tới `List` (hoặc `list` trong Python 3.9 trở lên).
+
+Có nghĩa là: "biến `items` là một `list`, và mỗi phần tử trong danh sách này là một `str`".
+
+!!! tip
+    Nếu bạn sử dụng Python 3.9 hoặc lớn hơn, bạn không phải import `List` từ `typing`, bạn có thể sử dụng `list` để thay thế.
+
+Bằng cách này, trình soạn thảo của bạn có thể hỗ trợ trong khi xử lí các phần tử trong danh sách:
+
+<img src="/img/python-types/image05.png">
+
+Đa phần đều không thể đạt được nếu không có các kiểu dữ liệu.
+
+Chú ý rằng, biến `item` là một trong các phần tử trong danh sách `items`.
+
+Và do vậy, trình soạn thảo biết nó là một `str`, và cung cấp sự hỗ trợ cho nó.
+
+#### Tuple and Set
+
+Bạn sẽ làm điều tương tự để khai báo các `tuple` và  các `set`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial007_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial007.py!}
+    ```
+
+Điều này có nghĩa là:
+
+* Biến `items_t` là một `tuple` với 3 phần tử, một `int`, một `int` nữa, và một `str`.
+* Biến `items_s` là một `set`, và mỗi phần tử của nó có kiểu `bytes`.
+
+#### Dict
+
+Để định nghĩa một `dict`, bạn truyền 2 tham số kiểu dữ liệu, phân cách bởi dấu phẩy.
+
+Tham số kiểu dữ liệu đầu tiên dành cho khóa của `dict`.
+
+Tham số kiểu dữ liệu thứ hai dành cho giá trị của `dict`.
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008.py!}
+    ```
+
+Điều này có nghĩa là:
+
+* Biến `prices` là một `dict`:
+    * Khóa của `dict` này là kiểu `str` (đó là tên của mỗi vật phẩm).
+    * Giá trị của `dict` này là kiểu `float` (đó là giá của mỗi vật phẩm).
+
+#### Union
+
+Bạn có thể khai báo rằng một biến có thể là **một vài kiểu dữ liệu" bất kì, ví dụ, một `int` hoặc một `str`.
+
+Trong Python 3.6 hoặc lớn hơn (bao gồm Python 3.10) bạn có thể sử dụng kiểu `Union` từ `typing` và đặt trong dấu ngoặc vuông những giá trị được chấp nhận.
+
+In Python 3.10 there's also a **new syntax** where you can put the possible types separated by a <abbr title='also called "bitwise or operator", but that meaning is not relevant here'>vertical bar (`|`)</abbr>.
+
+Trong Python 3.10 cũng có một **cú pháp mới** mà bạn có thể đặt những kiểu giá trị khả thi phân cách bởi một dấu <abbr title='cũng được gọi là "toán tử nhị phân"'>sổ dọc (`|`)</abbr>.
+
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008b.py!}
+    ```
+
+Trong cả hai trường hợp có nghĩa là `item` có thể là một `int` hoặc `str`.
+
+#### Khả năng `None`
+
+Bạn có thể khai báo một giá trị có thể có một kiểu dữ liệu, giống như `str`, nhưng nó cũng có thể là `None`.
+
+Trong Python 3.6 hoặc lớn hơn (bao gồm Python 3.10) bạn có thể khai báo nó bằng các import và sử dụng `Optional` từ mô đun `typing`.
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009.py!}
+```
+
+Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo giúp bạn phát hiện các lỗi mà bạn có thể gặp như một giá trị luôn là một `str`, trong khi thực tế nó rất có thể là `None`.
+
+`Optional[Something]` là một cách viết ngắn gọn của `Union[Something, None]`, chúng là tương đương nhau.
+
+Điều này cũng có nghĩa là trong Python 3.10, bạn có thể sử dụng `Something | None`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial009_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009.py!}
+    ```
+
+=== "Python 3.8+ alternative"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009b.py!}
+    ```
+
+#### Sử dụng `Union` hay `Optional`
+
+If you are using a Python version below 3.10, here's a tip from my very **subjective** point of view:
+
+Nếu bạn đang sử dụng phiên bản Python dưới 3.10, đây là một mẹo từ ý kiến rất "chủ quan" của tôi:
+
+* 🚨 Tránh sử dụng `Optional[SomeType]`
+* Thay vào đó ✨ **sử dụng `Union[SomeType, None]`** ✨.
+
+Cả hai là tương đương và bên dưới chúng giống nhau, nhưng tôi sẽ đễ xuất `Union` thay cho `Optional` vì từ "**tùy chọn**" có vẻ ngầm định giá trị là tùy chọn, và nó thực sự có nghĩa rằng "nó có thể là `None`", do đó nó không phải là tùy chọn và nó vẫn được yêu cầu.
+
+Tôi nghĩ `Union[SomeType, None]` là rõ ràng hơn về ý nghĩa của nó.
+
+Nó chỉ là về các từ và tên. Nhưng những từ đó có thể ảnh hưởng cách bạn và những đồng đội của bạn suy nghĩ về code.
+
+Cho một ví dụ, hãy để ý hàm này:
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009c.py!}
+```
+
+Tham số `name` được định nghĩa là `Optional[str]`, nhưng nó **không phải là tùy chọn**, bạn không thể gọi hàm mà không có tham số:
+
+```Python
+say_hi()  # Oh, no, this throws an error! 😱
+```
+
+Tham số `name` **vẫn được yêu cầu** (không phải là *tùy chọn*) vì nó không có giá trị mặc định. Trong khi đó, `name` chấp nhận `None` như là giá trị:
+
+```Python
+say_hi(name=None)  # This works, None is valid 🎉
+```
+
+Tin tốt là, khi bạn sử dụng Python 3.10, bạn sẽ không phải lo lắng về điều đó, bạn sẽ có thể sử dụng `|` để định nghĩa hợp của các kiểu dữ liệu một cách đơn giản:
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009c_py310.py!}
+```
+
+Và sau đó, bạn sẽ không phải lo rằng những cái tên như `Optional` và `Union`. 😎
+
+
+#### Những kiểu dữ liệu tổng quát
+
+Những kiểu dữ liệu này lấy tham số kiểu dữ liệu trong dấu ngoặc vuông được gọi là **Kiểu dữ liệu tổng quát**, cho ví dụ:
+
+=== "Python 3.10+"
+
+    Bạn có thể sử dụng các kiểu dữ liệu có sẵn như là kiểu dữ liệu tổng quát (với ngoặc vuông và kiểu dữ liệu bên trong):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    Và tương tự với Python 3.6, từ mô đun `typing`:
+
+    * `Union`
+    * `Optional` (tương tự như Python 3.6)
+    * ...và các kiểu dữ liệu khác.
+
+    Trong Python 3.10, thay vì sử dụng `Union` và `Optional`, bạn có thể sử dụng <abbr title='cũng gọi là "toán tử nhị phân", nhưng ý nghĩa không liên quan ở đây'>sổ dọc ('|')</abbr> để khai báo hợp của các kiểu dữ liệu, điều đó tốt hơn và đơn giản hơn nhiều.
+
+=== "Python 3.9+"
+
+    Bạn có thể sử dụng các kiểu dữ liệu có sẵn tương tự như (với ngoặc vuông và kiểu dữ liệu bên trong):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    Và tương tự với Python 3.6, từ mô đun `typing`:
+
+    * `Union`
+    * `Optional`
+    * ...and others.
+
+=== "Python 3.8+"
+
+    * `List`
+    * `Tuple`
+    * `Set`
+    * `Dict`
+    * `Union`
+    * `Optional`
+    * ...và các kiểu khác.
+
+### Lớp như kiểu dữ liệu
+
+Bạn cũng có thể khai báo một lớp như là kiểu dữ liệu của một biến.
+
+Hãy nói rằng bạn muốn có một lớp `Person` với một tên:
+
+```Python hl_lines="1-3"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Sau đó bạn có thể khai báo một biến có kiểu là `Person`:
+
+```Python hl_lines="6"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Và lại một lần nữa, bạn có được tất cả sự hỗ trợ từ trình soạn thảo:
+
+<img src="/img/python-types/image06.png">
+
+Lưu ý rằng, điều này có nghĩa rằng "`one_person`" là một **thực thể** của lớp `Person`.
+
+Nó không có nghĩa "`one_person`" là một **lớp** gọi là `Person`.
+
+## Pydantic models
+
+<a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> là một thư viện Python để validate dữ liệu hiệu năng cao.
+
+Bạn có thể khai báo "hình dạng" của dữa liệu như là các lớp với các thuộc tính.
+
+Và mỗi thuộc tính có một kiểu dữ liệu.
+
+Sau đó bạn tạo một thực thể của lớp đó với một vài giá trị và nó sẽ validate các giá trị, chuyển đổi chúng sang kiểu dữ liệu phù hợp (nếu đó là trường hợp) và cho bạn một object với toàn bộ dữ liệu.
+
+Và bạn nhận được tất cả sự hỗ trợ của trình soạn thảo với object kết quả đó.
+
+Một ví dụ từ tài liệu chính thức của Pydantic:
+
+=== "Python 3.10+"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011.py!}
+    ```
+
+!!! info
+    Để học nhiều hơn về <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic, tham khảo tài liệu của nó</a>.
+
+**FastAPI** được dựa hoàn toàn trên Pydantic.
+
+Bạn sẽ thấy nhiều ví dụ thực tế hơn trong [Hướng dẫn sử dụng](tutorial/index.md){.internal-link target=_blank}.
+
+!!! tip
+    Pydantic có một hành vi đặc biệt khi bạn sử dụng `Optional` hoặc `Union[Something, None]` mà không có giá trị mặc dịnh, bạn có thể đọc nhiều hơn về nó trong tài liệu của Pydantic về <a href="https://pydantic-docs.helpmanual.io/usage/models/#required-optional-fields" class="external-link" target="_blank">Required Optional fields</a>.
+
+
+## Type Hints với Metadata Annotations
+
+Python cũng có một tính năng cho phép đặt **metadata bổ sung** trong những gợi ý kiểu dữ liệu này bằng cách sử dụng `Annotated`.
+
+=== "Python 3.9+"
+
+    Trong Python 3.9, `Annotated` là một phần của thư viện chuẩn, do đó bạn có thể import nó từ `typing`.
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial013_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    Ở phiên bản dưới Python 3.9, bạn import `Annotated` từ `typing_extensions`.
+
+    Nó đã được cài đặt sẵng cùng với **FastAPI**.
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial013.py!}
+    ```
+
+Python bản thân nó không làm bất kì điều gì với `Annotated`. Với các trình soạn thảo và các công cụ khác, kiểu dữ liệu vẫn là `str`.
+
+Nhưng bạn có thể sử dụng `Annotated` để cung cấp cho **FastAPI** metadata bổ sung về cách mà bạn muốn ứng dụng của bạn xử lí.
+
+Điều quan trọng cần nhớ là ***tham số kiểu dữ liệu* đầu tiên** bạn truyền tới `Annotated` là **kiểu giá trị thực sự**. Phần còn lại chỉ là metadata cho các công cụ khác.
+
+Bây giờ, bạn chỉ cần biết rằng `Annotated` tồn tại, và nó là tiêu chuẩn của Python. 😎
+
+
+Sau đó, bạn sẽ thấy sự **mạnh mẽ** mà nó có thể làm.
+
+!!! tip
+    Thực tế, cái này là **tiêu chuẩn của Python**, nghĩa là bạn vẫn sẽ có được **trải nghiệm phát triển tốt nhất có thể** với trình soạn thảo của bạn, với các công cụ bạn sử dụng để phân tích và tái cấu trúc code của bạn, etc. ✨
+
+    Và code của bạn sẽ tương thích với nhiều công cụ và thư viện khác của Python. 🚀
+
+## Các gợi ý kiểu dữ liệu trong **FastAPI**
+
+**FastAPI** lấy các ưu điểm của các gợi ý kiểu dữ liệu để thực hiện một số thứ.
+
+Với **FastAPI**, bạn khai báo các tham số với gợi ý kiểu và bạn có được:
+
+* **Sự hỗ trợ từ các trình soạn thảo**.
+* **Kiểm tra kiểu dữ liệu (type checking)**.
+
+...và **FastAPI** sử dụng các khia báo để:
+
+* **Định nghĩa các yêu cầu**: từ tham số đường dẫn của request, tham số query, headers, bodies, các phụ thuộc (dependencies),...
+* **Chuyển dổi dữ liệu*: từ request sang kiểu dữ liệu được yêu cầu.
+* **Kiểm tra tính đúng đắn của dữ liệu**: tới từ mỗi request:
+    * Sinh **lỗi tự động** để trả về máy khác khi dữ liệu không hợp lệ.
+* **Tài liệu hóa** API sử dụng OpenAPI:
+    * cái mà sau được được sử dụng bởi tài liệu tương tác người dùng.
+
+Điều này có thể nghe trừu tượng. Đừng lo lắng. Bạn sẽ thấy tất cả chúng trong [Hướng dẫn sử dụng](tutorial/index.md){.internal-link target=_blank}.
+
+Điều quan trọng là bằng việc sử dụng các kiểu dữ liệu chuẩn của Python (thay vì thêm các lớp, decorators,...), **FastAPI** sẽ thực hiện nhiều công việc cho bạn.
+
+!!! info
+    Nếu bạn đã đi qua toàn bộ các hướng dẫn và quay trở lại để tìm hiểu nhiều hơn về các kiểu dữ liệu, một tài nguyên tốt như <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">"cheat sheet" từ `mypy`</a>.
diff --git a/docs/vi/docs/tutorial/first-steps.md b/docs/vi/docs/tutorial/first-steps.md
new file mode 100644
index 000000000..712f00852
--- /dev/null
+++ b/docs/vi/docs/tutorial/first-steps.md
@@ -0,0 +1,333 @@
+# Những bước đầu tiên
+
+Tệp tin FastAPI đơn giản nhất có thể trông như này:
+
+```Python
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Sao chép sang một tệp tin `main.py`.
+
+Chạy live server:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+!!! note
+    Câu lệnh `uvicorn main:app` được giải thích như sau:
+
+    * `main`: tệp tin `main.py` (một Python "mô đun").
+    * `app`: một object được tạo ra bên trong `main.py` với dòng `app = FastAPI()`.
+    * `--reload`: làm server khởi động lại sau mỗi lần thay đổi. Chỉ sử dụng trong môi trường phát triển.
+
+Trong output, có một dòng giống như:
+
+```hl_lines="4"
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+Dòng đó cho thấy URL, nơi mà app của bạn đang được chạy, trong máy local của bạn.
+
+### Kiểm tra
+
+Mở trình duyệt của bạn tại <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
+
+Bạn sẽ thấy một JSON response như:
+
+```JSON
+{"message": "Hello World"}
+```
+
+### Tài liệu tương tác API
+
+Bây giờ tới <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Bạn sẽ thấy một tài liệu tương tác API (cung cấp bởi <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Phiên bản thay thế của tài liệu API
+
+Và bây giờ tới <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Bạn sẽ thấy một bản thay thế của tài liệu (cung cấp bởi <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+### OpenAPI
+
+**FastAPI** sinh một "schema" với tất cả API của bạn sử dụng tiêu chuẩn **OpenAPI** cho định nghĩa các API.
+
+#### "Schema"
+
+Một "schema" là một định nghĩa hoặc mô tả thứ gì đó. Không phải code triển khai của nó, nhưng chỉ là một bản mô tả trừu tượng.
+
+#### API "schema"
+
+Trong trường hợp này, <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> là một bản mô tả bắt buộc cơ chế định nghĩa API của bạn.
+
+Định nghĩa cấu trúc này bao gồm những đường dẫn API của bạn, các tham số có thể có,...
+
+#### "Cấu trúc" dữ liệu
+
+Thuật ngữ "cấu trúc" (schema) cũng có thể được coi như là hình dạng của dữ liệu, tương tự như một JSON content.
+
+Trong trường hợp đó, nó có nghĩa là các thuộc tính JSON và các kiểu dữ liệu họ có,...
+
+#### OpenAPI và JSON Schema
+
+OpenAPI định nghĩa một cấu trúc API cho API của bạn. Và cấu trúc đó bao gồm các dịnh nghĩa (or "schema") về dữ liệu được gửi đi và nhận về bởi API của bạn, sử dụng **JSON Schema**, một tiêu chuẩn cho cấu trúc dữ liệu JSON.
+
+#### Kiểm tra `openapi.json`
+
+Nếu bạn tò mò về việc cấu trúc OpenAPI nhìn như thế nào thì FastAPI tự động sinh một JSON (schema) với các mô tả cho tất cả API của bạn.
+
+Bạn có thể thấy nó trực tiếp tại: <a href="http://127.0.0.1:8000/openapi.json" class="external-link" target="_blank">http://127.0.0.1:8000/openapi.json</a>.
+
+Nó sẽ cho thấy một JSON bắt đầu giống như:
+
+```JSON
+{
+    "openapi": "3.1.0",
+    "info": {
+        "title": "FastAPI",
+        "version": "0.1.0"
+    },
+    "paths": {
+        "/items/": {
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+
+
+
+...
+```
+
+#### OpenAPI dùng để làm gì?
+
+Cấu trúc OpenAPI là sức mạnh của tài liệu tương tác.
+
+Và có hàng tá các bản thay thế, tất cả đều dựa trên OpenAPI. Bạn có thể dễ dàng thêm bất kì bản thay thế bào cho ứng dụng của bạn được xây dựng với **FastAPI**.
+
+Bạn cũng có thể sử dụng nó để sinh code tự động, với các client giao viết qua API của bạn. Ví dụ, frontend, mobile hoặc các ứng dụng IoT.
+
+## Tóm lại, từng bước một
+
+### Bước 1: import `FastAPI`
+
+```Python hl_lines="1"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+`FastAPI` là một Python class cung cấp tất cả chức năng cho API của bạn.
+
+!!! note "Chi tiết kĩ thuật"
+    `FastAPI` là một class kế thừa trực tiếp `Starlette`.
+
+    Bạn cũng có thể sử dụng tất cả <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> chức năng với `FastAPI`.
+
+### Bước 2: Tạo một `FastAPI` "instance"
+
+```Python hl_lines="3"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Biến `app` này là một "instance" của class `FastAPI`.
+
+Đây sẽ là điểm cốt lõi để tạo ra tất cả API của bạn.
+
+`app` này chính là điều được nhắc tới bởi `uvicorn` trong câu lệnh:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Nếu bạn tạo ứng dụng của bạn giống như:
+
+```Python hl_lines="3"
+{!../../../docs_src/first_steps/tutorial002.py!}
+```
+
+Và đặt nó trong một tệp tin `main.py`, sau đó bạn sẽ gọi `uvicorn` giống như:
+
+<div class="termy">
+
+```console
+$ uvicorn main:my_awesome_api --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+### Bước 3: tạo một *đường dẫn toán tử*
+
+#### Đường dẫn
+
+"Đường dẫn" ở đây được nhắc tới là phần cuối cùng của URL bắt đầu từ `/`.
+
+Do đó, trong một URL nhìn giống như:
+
+```
+https://example.com/items/foo
+```
+
+...đường dẫn sẽ là:
+
+```
+/items/foo
+```
+
+!!! info
+    Một đường dẫn cũng là một cách gọi chung cho một "endpoint" hoặc một "route".
+
+Trong khi xây dựng một API, "đường dẫn" là các chính để phân tách "mối quan hệ" và "tài nguyên".
+
+#### Toán tử (Operation)
+
+"Toán tử" ở đây được nhắc tới là một trong các "phương thức" HTTP.
+
+Một trong những:
+
+* `POST`
+* `GET`
+* `PUT`
+* `DELETE`
+
+...và một trong những cái còn lại:
+
+* `OPTIONS`
+* `HEAD`
+* `PATCH`
+* `TRACE`
+
+Trong giao thức HTTP, bạn có thể giao tiếp trong mỗi đường dẫn sử dụng một (hoặc nhiều) trong các "phương thức này".
+
+---
+
+Khi xây dựng các API, bạn thường sử dụng cụ thể các phương thức HTTP này để thực hiện một hành động cụ thể.
+
+Thông thường, bạn sử dụng
+
+* `POST`: để tạo dữ liệu.
+* `GET`: để đọc dữ liệu.
+* `PUT`: để cập nhật dữ liệu.
+* `DELETE`: để xóa dữ liệu.
+
+Do đó, trong OpenAPI, mỗi phương thức HTTP được gọi là một "toán tử (operation)".
+
+Chúng ta cũng sẽ gọi chúng là "**các toán tử**".
+
+#### Định nghĩa moojt *decorator cho đường dẫn toán tử*
+
+```Python hl_lines="6"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+`@app.get("/")` nói **FastAPI** rằng hàm bên dưới có trách nhiệm xử lí request tới:
+
+* đường dẫn `/`
+* sử dụng một <abbr title="an HTTP GET method">toán tử<code>get</code></abbr>
+
+!!! info Thông tin về "`@decorator`"
+    Cú pháp `@something` trong Python được gọi là một "decorator".
+
+    Bạn đặt nó trên một hàm. Giống như một chiếc mũ xinh xắn (Tôi ddonas đó là lí do mà thuật ngữ này ra đời).
+
+    Một "decorator" lấy một hàm bên dưới và thực hiện một vài thứ với nó.
+
+    Trong trường hợp của chúng ta, decorator này nói **FastAPI** rằng hàm bên dưới ứng với **đường dẫn** `/` và một **toán tử** `get`.
+
+    Nó là một "**decorator đường dẫn toán tử**".
+
+Bạn cũng có thể sử dụng với các toán tử khác:
+
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+
+Và nhiều hơn với các toán tử còn lại:
+
+* `@app.options()`
+* `@app.head()`
+* `@app.patch()`
+* `@app.trace()`
+
+!!! tip
+    Bạn thoải mái sử dụng mỗi toán tử (phương thức HTTP) như bạn mơ ước.
+
+    **FastAPI** không bắt buộc bất kì ý nghĩa cụ thể nào.
+
+    Thông tin ở đây được biểu thị như là một chỉ dẫn, không phải là một yêu cầu bắt buộc.
+
+    Ví dụ, khi sử dụng GraphQL bạn thông thường thực hiện tất cả các hành động chỉ bằng việc sử dụng các toán tử `POST`.
+
+### Step 4: Định nghĩa **hàm cho đường dẫn toán tử**
+
+Đây là "**hàm cho đường dẫn toán tử**":
+
+* **đường dẫn**: là `/`.
+* **toán tử**: là `get`.
+* **hàm**: là hàm bên dưới "decorator" (bên dưới `@app.get("/")`).
+
+```Python hl_lines="7"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Đây là một hàm Python.
+
+Nó sẽ được gọi bởi **FastAPI** bất cứ khi nào nó nhận một request tới URL "`/`" sử dụng một toán tử `GET`.
+
+Trong trường hợp này, nó là một hàm `async`.
+
+---
+
+Bạn cũng có thể định nghĩa nó như là một hàm thông thường thay cho `async def`:
+
+```Python hl_lines="7"
+{!../../../docs_src/first_steps/tutorial003.py!}
+```
+
+!!! note
+    Nếu bạn không biết sự khác nhau, kiểm tra [Async: *"Trong khi vội vàng?"*](../async.md#in-a-hurry){.internal-link target=_blank}.
+
+### Bước 5: Nội dung trả về
+
+```Python hl_lines="8"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Bạn có thể trả về một `dict`, `list`, một trong những giá trị đơn như `str`, `int`,...
+
+Bạn cũng có thể trả về Pydantic model (bạn sẽ thấy nhiều hơn về nó sau).
+
+Có nhiều object và model khác nhau sẽ được tự động chuyển đổi sang JSON (bao gồm cả ORM,...). Thử sử dụng loại ưa thích của bạn, nó có khả năng cao đã được hỗ trợ.
+
+## Tóm lại
+
+* Import `FastAPI`.
+* Tạo một `app` instance.
+* Viết một **decorator cho đường dẫn toán tử** (giống như `@app.get("/")`).
+* Viết một **hàm cho đường dẫn toán tử** (giống như  `def root(): ...` ở trên).
+* Chạy server trong môi trường phát triển (giống như `uvicorn main:app --reload`).
diff --git a/docs/vi/docs/tutorial/index.md b/docs/vi/docs/tutorial/index.md
new file mode 100644
index 000000000..e8a93fe40
--- /dev/null
+++ b/docs/vi/docs/tutorial/index.md
@@ -0,0 +1,80 @@
+# Hướng dẫn sử dụng
+
+Hướng dẫn này cho bạn thấy từng bước cách sử dụng **FastAPI** đa số các tính năng của nó.
+
+Mỗi phần được xây dựng từ những phần trước đó, nhưng nó được cấu trúc thành các chủ đề riêng biệt, do đó bạn có thể xem trực tiếp từng phần cụ thể bất kì để giải quyết những API cụ thể mà bạn cần.
+
+Nó cũng được xây dựng để làm việc như một tham chiếu trong tương lai.
+
+Do đó bạn có thể quay lại và tìm chính xác những gì bạn cần.
+
+## Chạy mã
+
+Tất cả các code block có thể được sao chép và sử dụng trực tiếp (chúng thực chất là các tệp tin Python đã được kiểm thử).
+
+Để chạy bất kì ví dụ nào, sao chép code tới tệp tin `main.py`, và bắt đầu `uvicorn` với:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+**Khuyến khích** bạn viết hoặc sao chép code, sửa và chạy nó ở local.
+
+Sử dụng nó trong trình soạn thảo của bạn thực sự cho bạn thấy những lợi ích của FastAPI, thấy được cách bạn viết code ít hơn, tất cả đều được type check, autocompletion,...
+
+---
+
+## Cài đặt FastAPI
+
+Bước đầu tiên là cài đặt FastAPI.
+
+Với hướng dẫn này, bạn có thể muốn cài đặt nó với tất cả các phụ thuộc và tính năng tùy chọn:
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[all]"
+
+---> 100%
+```
+
+</div>
+
+...dó cũng bao gồm `uvicorn`, bạn có thể sử dụng như một server để chạy code của bạn.
+
+!!! note
+    Bạn cũng có thể cài đặt nó từng phần.
+
+    Đây là những gì bạn có thể sẽ làm một lần duy nhất bạn muốn triển khai ứng dụng của bạn lên production:
+
+    ```
+    pip install fastapi
+    ```
+
+    Cũng cài đặt `uvicorn` để làm việc như một server:
+
+    ```
+    pip install "uvicorn[standard]"
+    ```
+
+    Và tương tự với từng phụ thuộc tùy chọn mà bạn muốn sử dụng.
+
+## Hướng dẫn nâng cao
+
+Cũng có một **Hướng dẫn nâng cao** mà bạn có thể đọc nó sau **Hướng dẫn sử dụng**.
+
+**Hướng dẫn sử dụng nâng cao**, xây dựng dựa trên cái này, sử dụng các khái niệm tương tự, và dạy bạn những tính năng mở rộng.
+
+Nhưng bạn nên đọc **Hướng dẫn sử dụng** đầu tiên (những gì bạn đang đọc).
+
+Nó được thiết kế do đó bạn có thể xây dựng một ứng dụng hoàn chỉnh chỉ với **Hướng dẫn sử dụng**, và sau đó mở rộng nó theo các cách khác nhau, phụ thuộc vào những gì bạn cần, sử dụng một vài ý tưởng bổ sung từ **Hướng dẫn sử dụng nâng cao**.
diff --git a/docs/vi/mkdocs.yml b/docs/vi/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/vi/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml
diff --git a/docs/yo/docs/index.md b/docs/yo/docs/index.md
new file mode 100644
index 000000000..101e13b6b
--- /dev/null
+++ b/docs/yo/docs/index.md
@@ -0,0 +1,470 @@
+<p align="center">
+  <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
+</p>
+<p align="center">
+    <em>Ìlànà wẹ́ẹ́bù FastAPI, iṣẹ́ gíga, ó rọrùn láti kọ̀, o yára láti kóòdù, ó sì ṣetán fún iṣelọpọ ní lílo</em>
+</p>
+<p align="center">
+<a href="https://github.com/tiangolo/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" target="_blank">
+    <img src="https://github.com/tiangolo/fastapi/workflows/Test/badge.svg?event=push&branch=master" alt="Test">
+</a>
+<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/tiangolo/fastapi" target="_blank">
+    <img src="https://coverage-badge.samuelcolvin.workers.dev/tiangolo/fastapi.svg" alt="Coverage">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/v/fastapi?color=%2334D058&label=pypi%20package" alt="Package version">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions">
+</a>
+</p>
+
+---
+
+**Àkọsílẹ̀**: <a href="https://fastapi.tiangolo.com" target="_blank">https://fastapi.tiangolo.com</a>
+
+**Orisun Kóòdù**: <a href="https://github.com/tiangolo/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
+
+---
+
+FastAPI jẹ́ ìgbàlódé, tí ó yára (iṣẹ-giga), ìlànà wẹ́ẹ́bù fún kikọ àwọn API pẹ̀lú Python 3.8+ èyí tí ó da lori àwọn ìtọ́kasí àmì irúfẹ́ Python.
+
+Àwọn ẹya pàtàkì ni:
+
+* **Ó yára**: Iṣẹ tí ó ga púpọ̀, tí ó wa ni ibamu pẹ̀lú **NodeJS** àti **Go** (ọpẹ si Starlette àti Pydantic). [Ọkan nínú àwọn ìlànà Python ti o yára jùlọ ti o wa](#performance).
+* **Ó yára láti kóòdù**: O mu iyara pọ si láti kọ àwọn ẹya tuntun kóòdù nipasẹ "Igba ìdá ọgọ́rùn-ún" (i.e. 200%) si "ọ̀ọ́dúrún ìdá ọgọ́rùn-ún" (i.e. 300%).
+* **Àìtọ́ kékeré**: O n din aṣiṣe ku bi ọgbon ìdá ọgọ́rùn-ún (i.e. 40%) ti eda eniyan (oṣiṣẹ kóòdù) fa. *
+* **Ọgbọ́n àti ìmọ̀**: Atilẹyin olootu nla. <abbr title="a tun le pe ni olùrànlọ́wọ́ alaifiọwọkan alaifọwọyi, olùpari iṣẹ-ṣiṣe, Oloye">Ìparí</abbr> nibi gbogbo. Àkókò díẹ̀ nipa wíwá ibi tí ìṣòro kóòdù wà.
+* **Irọrun**: A kọ kí ó le rọrun láti lo àti láti kọ ẹkọ nínú rè. Ó máa fún ọ ní àkókò díẹ̀ látı ka àkọsílẹ.
+* **Ó kúkurú ní kikọ**: Ó dín àtúnkọ àti àtúntò kóòdù kù. Ìkéde àṣàyàn kọ̀ọ̀kan nínú rẹ̀ ní ọ̀pọ̀lọpọ̀ àwọn ìlò. O ṣe iranlọwọ láti má ṣe ní ọ̀pọ̀lọpọ̀ àṣìṣe.
+* **Ó lágbára**: Ó ń ṣe àgbéjáde kóòdù tí ó ṣetán fún ìṣelọ́pọ̀. Pẹ̀lú àkọsílẹ̀ tí ó máa ṣàlàyé ara rẹ̀ fún ẹ ní ìbáṣepọ̀ aládàáṣiṣẹ́ pẹ̀lú rè.
+* **Ajohunše/Ìtọ́kasí**: Ó da lori (àti ibamu ni kikun pẹ̀lú) àwọn ìmọ ajohunše/ìtọ́kasí fún àwọn API: <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> (èyí tí a mọ tẹlẹ si Swagger) àti <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>.
+
+<small>* iṣiro yi da lori àwọn idanwo tí ẹgbẹ ìdàgbàsókè FastAPI ṣe, nígbàtí wọn kọ àwọn ohun elo iṣelọpọ kóòdù pẹ̀lú rẹ.</small>
+
+## Àwọn onígbọ̀wọ́
+
+<!-- sponsors -->
+
+{% if sponsors %}
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor -%}
+{%- for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+<!-- /sponsors -->
+
+<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Àwọn onígbọ̀wọ́ míràn</a>
+
+## Àwọn ero àti èsì
+
+"_[...] Mò ń lo **FastAPI** púpọ̀ ní lẹ́nu àìpẹ́ yìí. [...] Mo n gbero láti lo o pẹ̀lú àwọn ẹgbẹ mi fún gbogbo iṣẹ **ML wa ni Microsoft**. Diẹ nínú wọn ni afikun ti ifilelẹ àwọn ẹya ara ti ọja **Windows** wa pẹ̀lú àwọn ti **Office**._"
+
+<div style="text-align: right; margin-right: 10%;">Kabir Khan - <strong>Microsoft</strong> <a href="https://github.com/tiangolo/fastapi/pull/26" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_A gba àwọn ohun èlò ìwé afọwọkọ **FastAPI** tí kò yí padà láti ṣẹ̀dá olùpín **REST** tí a lè béèrè lọ́wọ́ rẹ̀ láti gba **àsọtẹ́lẹ̀**. [fún Ludwig]_"
+
+<div style="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - <strong>Uber</strong> <a href="https://eng.uber.com/ludwig-v0-2/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_**Netflix** ni inudidun láti kede itusilẹ orisun kóòdù ti ìlànà iṣọkan **iṣakoso Ìṣòro** wa: **Ìfiránṣẹ́**! [a kọ pẹ̀lú **FastAPI**]_"
+
+<div style="text-align: right; margin-right: 10%;">Kevin Glisson, Marc Vilanova, Forest Monsen - <strong>Netflix</strong> <a href="https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Inú mi dùn púpọ̀ nípa **FastAPI**. Ó mú inú ẹnì dùn púpọ̀!_"
+
+<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">Python Bytes</a> podcast host</strong> <a href="https://twitter.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ní tòótọ́, ohun tí o kọ dára ó sì tún dán. Ní ọ̀pọ̀lọpọ̀ ọ̀nà, ohun tí mo fẹ́ kí **Hug** jẹ́ nìyẹn - ó wúni lórí gan-an láti rí ẹnìkan tí ó kọ́ nǹkan bí èyí._"
+
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ti o ba n wa láti kọ ọkan **ìlànà igbalode** fún kikọ àwọn REST API, ṣayẹwo **FastAPI** [...] Ó yára, ó rọrùn láti lò, ó sì rọrùn láti kọ́[...]_"
+
+"_A ti yipada si **FastAPI** fún **APIs** wa [...] Mo lérò pé wà á fẹ́ràn rẹ̀ [...]_"
+
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong><a href="https://explosion.ai" target="_blank">Explosion AI</a> founders - <a href="https://spacy.io" target="_blank">spaCy</a> creators</strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ti ẹnikẹni ba n wa láti kọ iṣelọpọ API pẹ̀lú Python, èmi yóò ṣe'dúró fún **FastAPI**. Ó jẹ́ ohun tí **àgbékalẹ̀ rẹ̀ lẹ́wà**, **ó rọrùn láti lò** àti wipe ó ni **ìwọ̀n gíga**, o tí dí **bọtini paati** nínú alakọkọ API ìdàgbàsókè kikọ fún wa, àti pe o ni ipa lori adaṣiṣẹ àti àwọn iṣẹ gẹ́gẹ́ bíi Onímọ̀-ẹ̀rọ TAC tí órí Íńtánẹ́ẹ̀tì_"
+
+<div style="text-align: right; margin-right: 10%;">Deon Pillsbury - <strong>Cisco</strong> <a href="https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+## **Typer**, FastAPI ti CLIs
+
+<a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
+
+Ti o ba n kọ ohun èlò <abbr title="Command Line Interface">CLI</abbr> láti ṣeé lọ nínú ohun èlò lori ebute kọmputa dipo API, ṣayẹwo <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>.
+
+**Typer** jẹ́ àbúrò ìyá FastAPI kékeré. Àti pé wọ́n kọ́ láti jẹ́ **FastAPI ti CLIs**. ⌨️ 🚀
+
+## Èròjà
+
+Python 3.8+
+
+FastAPI dúró lórí àwọn èjìká tí àwọn òmíràn:
+
+* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> fún àwọn ẹ̀yà ayélujára.
+* <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> fún àwọn ẹ̀yà àkójọf'áyẹ̀wò.
+
+## Fifi sórí ẹrọ
+
+<div class="termy">
+
+```console
+$ pip install fastapi
+
+---> 100%
+```
+
+</div>
+Iwọ yóò tún nílò olupin ASGI, fún iṣelọpọ bii <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a> tabi <a href="https://github.com/pgjones/hypercorn" class="external-link" target="_blank">Hypercorn</a>.
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]"
+
+---> 100%
+```
+
+</div>
+
+## Àpẹẹrẹ
+
+### Ṣẹ̀dá rẹ̀
+
+* Ṣẹ̀dá fáìlì `main.py (èyí tíí ṣe, akọkọ.py)` pẹ̀lú:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+<details markdown="1">
+<summary>Tàbí lò <code>async def</code>...</summary>
+
+Tí kóòdù rẹ̀ bá ń lò `async` / `await`, lò `async def`:
+
+```Python hl_lines="9  14"
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+async def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+**Akiyesi**:
+
+Tí o kò bá mọ̀, ṣàyẹ̀wò ibi tí a ti ní _"In a hurry?"_ (i.e. _"Ní kíákíá?"_) nípa <a href="https://fastapi.tiangolo.com/async/#in-a-hurry" target="_blank">`async` and `await` nínú àkọsílẹ̀</a>.
+
+</details>
+
+### Mu ṣiṣẹ
+
+Mú olupin ṣiṣẹ pẹ̀lú:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+INFO:     Started reloader process [28720]
+INFO:     Started server process [28722]
+INFO:     Waiting for application startup.
+INFO:     Application startup complete.
+```
+
+</div>
+
+<details markdown="1">
+<summary>Nipa aṣẹ kóòdù náà <code>uvicorn main:app --reload</code>...</summary>
+
+Àṣẹ `uvicorn main:app` ń tọ́ka sí:
+
+* `main`: fáìlì náà 'main.py' (Python "module").
+* `app` jẹ object( i.e. nǹkan) tí a ṣẹ̀dá nínú `main.py` pẹ̀lú ilà `app = FastAPI()`.
+* `--reload`: èyí yóò jẹ́ ki olupin tún bẹ̀rẹ̀ lẹ́hìn àwọn àyípadà kóòdù. Jọ̀wọ́, ṣe èyí fún ìdàgbàsókè kóòdù nìkan, má ṣe é ṣe lori àgbéjáde kóòdù tabi fún iṣelọpọ kóòdù.
+
+
+</details>
+
+### Ṣayẹwo rẹ
+
+Ṣii aṣàwákiri kọ̀ǹpútà rẹ ni <a href="http://127.0.0.1:8000/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
+
+Ìwọ yóò sì rí ìdáhùn JSON bíi:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+O tí ṣẹ̀dá API èyí tí yóò:
+
+* Gbà àwọn ìbéèrè HTTP ni àwọn _ipa ọ̀nà_ `/` àti `/items/{item_id}`.
+* Èyí tí àwọn _ipa ọ̀nà_ (i.e. _paths_) méjèèjì gbà àwọn <em>iṣẹ</em> `GET` (a tun mọ si _àwọn ọna_ HTTP).
+* Èyí tí _ipa ọ̀nà_  (i.e. _paths_) `/items/{item_id}` ní _àwọn ohun-ini ipa ọ̀nà_ tí ó yẹ kí ó jẹ́ `int` i.e. `ÒǸKÀ`.
+* Èyí tí _ipa ọ̀nà_  (i.e. _paths_) `/items/{item_id}` ní àṣàyàn `str` _àwọn ohun-ini_ (i.e. _query parameter_) `q`.
+
+### Ìbáṣepọ̀ àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Lẹ́yìn náà, iwọ yóò rí ìdáhùn àkọsílẹ̀ API tí ó jẹ́ ìbáṣepọ̀ alaifọwọyi/aládàáṣiṣẹ́ (tí a pèṣè nípaṣẹ̀ <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Ìdàkejì àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Wà á rí àwọn àkọsílẹ̀ aládàáṣiṣẹ́ mìíràn (tí a pese nipasẹ <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Àpẹẹrẹ ìgbésókè mìíràn
+
+Ní báyìí ṣe àtúnṣe fáìlì `main.py` láti gba kókó èsì láti inú ìbéèrè `PUT`.
+
+Ní báyìí, ṣe ìkéde kókó èsì API nínú kóòdù rẹ nipa lílo àwọn ìtọ́kasí àmì irúfẹ́ Python, ọpẹ́ pàtàkìsi sí Pydantic.
+
+```Python hl_lines="4  9-12  25-27"
+from typing import Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    price: float
+    is_offer: Union[bool, None] = None
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+
+
+@app.put("/items/{item_id}")
+def update_item(item_id: int, item: Item):
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+Olupin yóò tún ṣe àtúnṣe laifọwọyi/aládàáṣiṣẹ́ (nítorí wípé ó se àfikún `-reload` si àṣẹ kóòdù `uvicorn` lókè).
+
+### Ìbáṣepọ̀ ìgbésókè àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+* Ìbáṣepọ̀ àkọsílẹ̀ API yóò ṣe imudojuiwọn àkọsílẹ̀ API laifọwọyi, pẹ̀lú kókó èsì ìdáhùn API tuntun:
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Tẹ bọtini "Gbiyanju rẹ" i.e. "Try it out", yóò gbà ọ́ láàyè láti jẹ́ kí ó tẹ́ àlàyé tí ó nílò kí ó le sọ̀rọ̀ tààrà pẹ̀lú API:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-04-swagger-03.png)
+
+* Lẹhinna tẹ bọtini "Ṣiṣe" i.e. "Execute", olùmúlò (i.e. user interface) yóò sọrọ pẹ̀lú API rẹ, yóò ṣe afiranṣẹ àwọn èròjà, pàápàá jùlọ yóò gba àwọn àbájáde yóò si ṣafihan wọn loju ìbòjú:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png)
+
+### Ìdàkejì ìgbésókè àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+* Ìdàkejì àkọsílẹ̀ API yóò ṣ'afihan ìbéèrè èròjà/pàrámítà tuntun àti kókó èsì ti API:
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Àtúnyẹ̀wò
+
+Ni akopọ, ìwọ yóò kéde ni **kete** àwọn iru èròjà/pàrámítà, kókó èsì API, abbl (i.e. àti bẹbẹ lọ), bi àwọn èròjà iṣẹ.
+
+O ṣe ìyẹn pẹ̀lú irúfẹ́ àmì ìtọ́kasí ìgbàlódé Python.
+
+O ò nílò láti kọ́ síńtáàsì tuntun, ìlànà tàbí ọ̀wọ́ kíláàsì kan pàtó, abbl (i.e. àti bẹbẹ lọ).
+
+Ìtọ́kasí **Python 3.8+**
+
+Fún àpẹẹrẹ, fún `int`:
+
+```Python
+item_id: int
+```
+
+tàbí fún àwòṣe `Item` tí ó nira díẹ̀ síi:
+
+```Python
+item: Item
+```
+
+... àti pẹ̀lú ìkéde kan ṣoṣo yẹn ìwọ yóò gbà:
+
+* Atilẹyin olootu, pẹ̀lú:
+    * Pipari.
+    * Àyẹ̀wò irúfẹ́ àmì ìtọ́kasí.
+* Ìfọwọ́sí àkójọf'áyẹ̀wò (i.e. data):
+    * Aṣiṣe alaifọwọyi/aládàáṣiṣẹ́ àti aṣiṣe ti ó hàn kedere nígbàtí àwọn àkójọf'áyẹ̀wò (i.e. data) kò wulo tabi tí kò fẹsẹ̀ múlẹ̀.
+    * Ìfọwọ́sí fún ohun elo JSON tí ó jìn gan-an.
+* <abbr title="also known as: serialization, parsing, marshalling">Ìyípadà</abbr> tí input àkójọf'áyẹ̀wò: tí ó wà láti nẹtiwọọki si àkójọf'áyẹ̀wò àti irúfẹ́ àmì ìtọ́kasí Python. Ó ń ka láti:
+    * JSON.
+    * èròjà ọ̀nà tí ò gbé gbà.
+    * èròjà ìbéèrè.
+    * Àwọn Kúkì
+    * Àwọn Àkọlé
+    * Àwọn Fọọmu
+    * Àwọn Fáìlì
+* <abbr title="a tún má ń pè ni: serialization, parsing, marshalling">Ìyípadà</abbr> èsì àkójọf'áyẹ̀wò: yíyípadà láti àkójọf'áyẹ̀wò àti irúfẹ́ àmì ìtọ́kasí Python si nẹtiwọọki (gẹ́gẹ́ bí JSON):
+    * Yí irúfẹ́ àmì ìtọ́kasí padà (`str`, `int`, `float`, `bool`, `list`, abbl i.e. àti bèbè ló).
+    * Àwọn ohun èlò `datetime`.
+    * Àwọn ohun èlò `UUID`.
+    * Àwọn awoṣẹ́ ibi ìpamọ́ àkójọf'áyẹ̀wò.
+    * ...àti ọ̀pọ̀lọpọ̀ díẹ̀ síi.
+* Ìbáṣepọ̀ àkọsílẹ̀ API aládàáṣiṣẹ́, pẹ̀lú ìdàkejì àgbékalẹ̀-àwọn-olùmúlò (i.e user interfaces) méjì:
+    * Àgbékalẹ̀-olùmúlò Swagger.
+    * ReDoc.
+
+---
+
+Nisinsin yi, tí ó padà sí àpẹẹrẹ ti tẹ́lẹ̀, **FastAPI** yóò:
+
+* Fọwọ́ sí i pé `item_id` wà nínú ọ̀nà ìbéèrè HTTP fún `GET` àti `PUT`.
+* Fọwọ́ sí i pé `item_id` jẹ́ irúfẹ́ àmì ìtọ́kasí `int` fún ìbéèrè HTTP `GET` àti `PUT`.
+    * Tí kìí bá ṣe bẹ, oníbàárà yóò ríi àṣìṣe tí ó wúlò, kedere.
+* Ṣàyẹ̀wò bóyá ìbéèrè àṣàyàn pàrámítà kan wà tí orúkọ rẹ̀ ń jẹ́ `q` (gẹ́gẹ́ bíi `http://127.0.0.1:8000/items/foo?q=somequery`) fún ìbéèrè HTTP `GET`.
+    * Bí wọ́n ṣe kéde pàrámítà `q` pẹ̀lú `= None`, ó jẹ́ àṣàyàn (i.e optional).
+    * Láìsí `None` yóò nílò (gẹ́gẹ́ bí kókó èsì ìbéèrè HTTP ṣe wà pẹ̀lú `PUT`).
+* Fún àwọn ìbéèrè HTTP `PUT` sí `/items/{item_id}`, kà kókó èsì ìbéèrè HTTP gẹ́gẹ́ bí JSON:
+    * Ṣàyẹ̀wò pé ó ní àbùdá tí ó nílò èyí tíí ṣe `name` i.e. `orúkọ` tí ó yẹ kí ó jẹ́ `str`.
+    * Ṣàyẹ̀wò pé ó ní àbùdá tí ó nílò èyí tíí ṣe `price` i.e. `iye` tí ó gbọ́dọ̀ jẹ́ `float`.
+    * Ṣàyẹ̀wò pé ó ní àbùdá àṣàyàn `is_offer`, tí ó yẹ kí ó jẹ́ `bool`, tí ó bá wà níbẹ̀.
+    * Gbogbo èyí yóò tún ṣiṣẹ́ fún àwọn ohun èlò JSON tí ó jìn gidi gan-an.
+* Yìí padà láti àti sí JSON lai fi ọwọ́ yi.
+* Ṣe àkọsílẹ̀ ohun gbogbo pẹ̀lú OpenAPI, èyí tí yóò wà ní lílo nípaṣẹ̀:
+    * Àwọn ètò àkọsílẹ̀ ìbáṣepọ̀.
+    * Aládàáṣiṣẹ́ oníbárà èlètò tíí ṣẹ̀dá kóòdù, fún ọ̀pọ̀lọpọ̀ àwọn èdè.
+* Pese àkọsílẹ̀ òní ìbáṣepọ̀ ti àwọn àgbékalẹ̀ ayélujára méjì tààrà.
+
+---
+
+A ń ṣẹ̀ṣẹ̀ ń mú ẹyẹ bọ́ làpò ní, ṣùgbọ́n ó ti ni òye bí gbogbo rẹ̀ ṣe ń ṣiṣẹ́.
+
+Gbiyanju láti yí ìlà padà pẹ̀lú:
+
+```Python
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+...láti:
+
+```Python
+        ... "item_name": item.name ...
+```
+
+...ṣí:
+
+```Python
+        ... "item_price": item.price ...
+```
+
+.. kí o sì wo bí olóòtú rẹ yóò ṣe parí àwọn àbùdá náà fúnra rẹ̀, yóò sì mọ irúfẹ́ wọn:
+
+![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+Fún àpẹẹrẹ pípé síi pẹ̀lú àwọn àbùdá mìíràn, wo <a href="https://fastapi.tiangolo.com/tutorial/">Ìdánilẹ́kọ̀ọ́ - Ìtọ́sọ́nà Olùmúlò</a>.
+
+**Itaniji gẹ́gẹ́ bí isọ'ye**: ìdánilẹ́kọ̀ọ́ - itọsọna olùmúlò pẹ̀lú:
+
+* Ìkéde àṣàyàn **pàrámítà** láti àwọn oriṣiriṣi ibòmíràn gẹ́gẹ́ bíi: àwọn **àkọlé èsì API**, **kúkì**, **ààyè fọọmu**, àti **fáìlì**.
+* Bíi ó ṣe lé ṣètò **àwọn ìdíwọ́ ìfọwọ́sí** bí `maximum_length` tàbí `regex`.
+* Ó lágbára púpọ̀ ó sì rọrùn láti lo ètò **<abbr title="a tún mọ̀ sí ìrìnṣẹ́, àwọn ohun àmúlò iṣẹ́, olupese, àwọn ohun àfikún ">Àfikún Ìgbẹ́kẹ̀lé Kóòdù</abbr>**.
+* Ààbò àti ìfọwọ́sowọ́pọ̀, pẹ̀lú àtìlẹ́yìn fún **OAuth2** pẹ̀lú **àmì JWT** àti **HTTP Ipilẹ ìfọwọ́sowọ́pọ̀**.
+* Àwọn ìlànà ìlọsíwájú (ṣùgbọ́n tí ó rọrùn bákan náà) fún ìkéde **àwọn àwòṣe JSON tó jinlẹ̀** (ọpẹ́ pàtàkìsi sí Pydantic).
+* Iṣọpọ **GraphQL** pẹ̀lú <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> àti àwọn ohun èlò ìwé kóòdù afọwọkọ mìíràn tí kò yí padà.
+* Ọpọlọpọ àwọn àfikún àwọn ẹ̀yà (ọpẹ́ pàtàkìsi sí Starlette) bí:
+    * **WebSockets**
+    * àwọn ìdánwò tí ó rọrùn púpọ̀ lórí HTTPX àti `pytest`
+    * **CORS**
+    * **Cookie Sessions**
+    * ...àti síwájú síi.
+
+## Ìṣesí
+
+Àwọn àlá TechEmpower fi hàn pé **FastAPI** ń ṣiṣẹ́ lábẹ́ Uvicorn gẹ́gẹ́ bí <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">ọ̀kan lára àwọn ìlànà Python tí ó yára jùlọ tí ó wà</a>, ní ìsàlẹ̀ Starlette àti Uvicorn fúnra wọn (tí FastAPI ń lò fúnra rẹ̀). (*)
+
+Láti ní òye síi nípa rẹ̀, wo abala àwọn <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Àlá</a>.
+
+## Àṣàyàn Àwọn Àfikún Ìgbẹ́kẹ̀lé Kóòdù
+
+Èyí tí Pydantic ń lò:
+
+* <a href="https://github.com/JoshData/python-email-validator" target="_blank"><code>email_validator</code></a> - fún ifọwọsi ímeèlì.
+* <a href="https://docs.pydantic.dev/latest/usage/pydantic_settings/" target="_blank"><code>pydantic-settings</code></a> - fún ètò ìsàkóso.
+* <a href="https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/" target="_blank"><code>pydantic-extra-types</code></a> - fún àfikún oríṣi láti lọ pẹ̀lú Pydantic.
+
+Èyí tí Starlette ń lò:
+
+* <a href="https://www.python-httpx.org" target="_blank"><code>httpx</code></a> - Nílò tí ó bá fẹ́ láti lọ `TestClient`.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Nílò tí ó bá fẹ́ láti lọ iṣeto awoṣe aiyipada.
+* <a href="https://andrew-d.github.io/python-multipart/" target="_blank"><code>python-multipart</code></a> - Nílò tí ó bá fẹ́ láti ṣe àtìlẹ́yìn fún <abbr title="tí ó se ìyípadà ọ̀rọ̀-ìyọ̀/òkun-ọ̀rọ̀ tí ó wà láti ìbéèrè HTTP sí inú àkójọf'áyẹ̀wò Python">"àyẹ̀wò"</abbr> fọọmu, pẹ̀lú `request.form()`.
+* <a href="https://pythonhosted.org/itsdangerous/" target="_blank"><code>itsdangerous</code></a> - Nílò fún àtìlẹ́yìn `SessionMiddleware`.
+* <a href="https://pyyaml.org/wiki/PyYAMLDocumentation" target="_blank"><code>pyyaml</code></a> - Nílò fún àtìlẹ́yìn Starlette's `SchemaGenerator` (ó ṣe ṣe kí ó má nílò rẹ̀ fún FastAPI).
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - Nílò tí ó bá fẹ́ láti lọ `UJSONResponse`.
+
+Èyí tí FastAPI / Starlette ń lò:
+
+* <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - Fún olupin tí yóò sẹ́ àmúyẹ àti tí yóò ṣe ìpèsè fún iṣẹ́ rẹ tàbí ohun èlò rẹ.
+* <a href="https://github.com/ijl/orjson" target="_blank"><code>orjson</code></a> - Nílò tí ó bá fẹ́ láti lọ `ORJSONResponse`.
+
+Ó lè fi gbogbo àwọn wọ̀nyí sórí ẹrọ pẹ̀lú `pip install "fastapi[all]"`.
+
+## Iwe-aṣẹ
+
+Iṣẹ́ yìí ni iwe-aṣẹ lábẹ́ àwọn òfin tí iwe-aṣẹ MIT.
diff --git a/docs/yo/mkdocs.yml b/docs/yo/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/yo/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml
diff --git a/docs/zh/docs/advanced/generate-clients.md b/docs/zh/docs/advanced/generate-clients.md
new file mode 100644
index 000000000..e222e479c
--- /dev/null
+++ b/docs/zh/docs/advanced/generate-clients.md
@@ -0,0 +1,266 @@
+# 生成客户端
+
+因为 **FastAPI** 是基于OpenAPI规范的，自然您可以使用许多相匹配的工具，包括自动生成API文档 (由 Swagger UI 提供)。
+
+一个不太明显而又特别的优势是，你可以为你的API针对不同的**编程语言**来**生成客户端**(有时候被叫做 <abbr title="Software Development Kits">**SDKs**</abbr> )。
+
+## OpenAPI 客户端生成
+
+有许多工具可以从**OpenAPI**生成客户端。
+
+一个常见的工具是 <a href="https://openapi-generator.tech/" class="external-link" target="_blank">OpenAPI Generator</a>。
+
+如果您正在开发**前端**，一个非常有趣的替代方案是 <a href="https://github.com/ferdikoomen/openapi-typescript-codegen" class="external-link" target="_blank">openapi-typescript-codegen</a>。
+
+## 生成一个 TypeScript 前端客户端
+
+让我们从一个简单的 FastAPI 应用开始：
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="7-9  12-13  16-17  21"
+    {!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9-11  14-15  18  19  23"
+    {!> ../../../docs_src/generate_clients/tutorial001.py!}
+    ```
+
+请注意，*路径操作* 定义了他们所用于请求数据和回应数据的模型，所使用的模型是`Item` 和 `ResponseMessage`。
+
+### API 文档
+
+如果您访问API文档，您将看到它具有在请求中发送和在响应中接收数据的**模式(schemas)**：
+
+<img src="/img/tutorial/generate-clients/image01.png">
+
+您可以看到这些模式，因为它们是用程序中的模型声明的。
+
+那些信息可以在应用的 **OpenAPI模式** 被找到，然后显示在API文档中（通过Swagger UI）。
+
+OpenAPI中所包含的模型里有相同的信息可以用于 **生成客户端代码**。
+
+### 生成一个TypeScript 客户端
+
+现在我们有了带有模型的应用，我们可以为前端生成客户端代码。
+
+#### 安装 `openapi-typescript-codegen`
+
+您可以使用以下工具在前端代码中安装 `openapi-typescript-codegen`:
+
+<div class="termy">
+
+```console
+$ npm install openapi-typescript-codegen --save-dev
+
+---> 100%
+```
+
+</div>
+
+#### 生成客户端代码
+
+要生成客户端代码，您可以使用现在将要安装的命令行应用程序 `openapi`。
+
+因为它安装在本地项目中，所以您可能无法直接使用此命令，但您可以将其放在 `package.json` 文件中。
+
+它可能看起来是这样的:
+
+```JSON  hl_lines="7"
+{
+  "name": "frontend-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "generate-client": "openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios"
+  },
+  "author": "",
+  "license": "",
+  "devDependencies": {
+    "openapi-typescript-codegen": "^0.20.1",
+    "typescript": "^4.6.2"
+  }
+}
+```
+
+在这里添加 NPM `generate-client` 脚本后，您可以使用以下命令运行它:
+
+<div class="termy">
+
+```console
+$ npm run generate-client
+
+frontend-app@1.0.0 generate-client /home/user/code/frontend-app
+> openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios
+```
+
+</div>
+
+此命令将在 `./src/client` 中生成代码，并将在其内部使用 `axios`（前端HTTP库）。
+
+### 尝试客户端代码
+
+现在您可以导入并使用客户端代码，它可能看起来像这样，请注意，您可以为这些方法使用自动补全：
+
+<img src="/img/tutorial/generate-clients/image02.png">
+
+您还将自动补全要发送的数据：
+
+<img src="/img/tutorial/generate-clients/image03.png">
+
+!!! tip
+    请注意， `name` 和 `price` 的自动补全，是通过其在`Item`模型(FastAPI)中的定义实现的。
+
+如果发送的数据字段不符，你也会看到编辑器的错误提示:
+
+<img src="/img/tutorial/generate-clients/image04.png">
+
+响应(response)对象也拥有自动补全:
+
+<img src="/img/tutorial/generate-clients/image05.png">
+
+## 带有标签的 FastAPI 应用
+
+在许多情况下，你的FastAPI应用程序会更复杂，你可能会使用标签来分隔不同组的*路径操作(path operations)*。
+
+例如，您可以有一个用 `items` 的部分和另一个用于 `users` 的部分，它们可以用标签来分隔：
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="21  26  34"
+    {!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="23  28  36"
+    {!> ../../../docs_src/generate_clients/tutorial002.py!}
+    ```
+
+### 生成带有标签的 TypeScript 客户端
+
+如果您使用标签为FastAPI应用生成客户端，它通常也会根据标签分割客户端代码。
+
+通过这种方式，您将能够为客户端代码进行正确地排序和分组：
+
+<img src="/img/tutorial/generate-clients/image06.png">
+
+在这个案例中，您有：
+
+* `ItemsService`
+* `UsersService`
+
+### 客户端方法名称
+
+现在生成的方法名像 `createItemItemsPost` 看起来不太简洁:
+
+```TypeScript
+ItemsService.createItemItemsPost({name: "Plumbus", price: 5})
+```
+
+...这是因为客户端生成器为每个 *路径操作* 使用OpenAPI的内部 **操作 ID(operation ID)**。
+
+OpenAPI要求每个操作 ID 在所有 *路径操作* 中都是唯一的，因此 FastAPI 使用**函数名**、**路径**和**HTTP方法/操作**来生成此操作ID，因为这样可以确保这些操作 ID 是唯一的。
+
+但接下来我会告诉你如何改进。 🤓
+
+## 自定义操作ID和更好的方法名
+
+您可以**修改**这些操作ID的**生成**方式，以使其更简洁，并在客户端中具有**更简洁的方法名称**。
+
+在这种情况下，您必须确保每个操作ID在其他方面是**唯一**的。
+
+例如，您可以确保每个*路径操作*都有一个标签，然后根据**标签**和*路径操作***名称**（函数名）来生成操作ID。
+
+### 自定义生成唯一ID函数
+
+FastAPI为每个*路径操作*使用一个**唯一ID**，它用于**操作ID**，也用于任何所需自定义模型的名称，用于请求或响应。
+
+你可以自定义该函数。它接受一个 `APIRoute` 对象作为输入，并输出一个字符串。
+
+例如，以下是一个示例，它使用第一个标签（你可能只有一个标签）和*路径操作*名称（函数名）。
+
+然后，你可以将这个自定义函数作为 `generate_unique_id_function` 参数传递给 **FastAPI**:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="6-7  10"
+    {!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="8-9  12"
+    {!> ../../../docs_src/generate_clients/tutorial003.py!}
+    ```
+
+### 使用自定义操作ID生成TypeScript客户端
+
+现在，如果你再次生成客户端，你会发现它具有改善的方法名称：
+
+<img src="/img/tutorial/generate-clients/image07.png">
+
+正如你所见，现在方法名称中只包含标签和函数名，不再包含URL路径和HTTP操作的信息。
+
+### 预处理用于客户端生成器的OpenAPI规范
+
+生成的代码仍然存在一些**重复的信息**。
+
+我们已经知道该方法与 **items** 相关，因为它在 `ItemsService` 中（从标签中获取），但方法名中仍然有标签名作为前缀。😕
+
+一般情况下对于OpenAPI，我们可能仍然希望保留它，因为这将确保操作ID是**唯一的**。
+
+但对于生成的客户端，我们可以在生成客户端之前**修改** OpenAPI 操作ID，以使方法名称更加美观和**简洁**。
+
+我们可以将 OpenAPI JSON 下载到一个名为`openapi.json`的文件中，然后使用以下脚本**删除此前缀的标签**：
+
+```Python
+{!../../../docs_src/generate_clients/tutorial004.py!}
+```
+
+通过这样做，操作ID将从类似于 `items-get_items` 的名称重命名为 `get_items` ，这样客户端生成器就可以生成更简洁的方法名称。
+
+### 使用预处理的OpenAPI生成TypeScript客户端
+
+现在，由于最终结果保存在文件openapi.json中，你可以修改 package.json 文件以使用此本地文件，例如：
+
+```JSON  hl_lines="7"
+{
+  "name": "frontend-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "generate-client": "openapi --input ./openapi.json --output ./src/client --client axios"
+  },
+  "author": "",
+  "license": "",
+  "devDependencies": {
+    "openapi-typescript-codegen": "^0.20.1",
+    "typescript": "^4.6.2"
+  }
+}
+```
+
+生成新的客户端之后，你现在将拥有**清晰的方法名称**，具备**自动补全**、**错误提示**等功能：
+
+<img src="/img/tutorial/generate-clients/image08.png">
+
+## 优点
+
+当使用自动生成的客户端时，你将获得以下的自动补全功能：
+
+* 方法。
+* 请求体中的数据、查询参数等。
+* 响应数据。
+
+你还将获得针对所有内容的错误提示。
+
+每当你更新后端代码并**重新生成**前端代码时，新的*路径操作*将作为方法可用，旧的方法将被删除，并且其他任何更改将反映在生成的代码中。 🤓
+
+这也意味着如果有任何更改，它将自动**反映**在客户端代码中。如果你**构建**客户端，在使用的数据上存在**不匹配**时，它将报错。
+
+因此，你将在开发周期的早期**检测到许多错误**，而不必等待错误在生产环境中向最终用户展示，然后尝试调试问题所在。 ✨
diff --git a/docs/zh/docs/advanced/settings.md b/docs/zh/docs/advanced/settings.md
index 597e99a77..76070fb7f 100644
--- a/docs/zh/docs/advanced/settings.md
+++ b/docs/zh/docs/advanced/settings.md
@@ -223,13 +223,13 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="6  12-13"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ 非注解版本"
+=== "Python 3.8+ 非注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -239,7 +239,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
     ```
 
 !!! tip
-    我们稍后会讨论 `@lru_cache()`。
+    我们稍后会讨论 `@lru_cache`。
 
     目前，您可以将 `get_settings()` 视为普通函数。
 
@@ -251,13 +251,13 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  19-21"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ 非注解版本"
+=== "Python 3.8+ 非注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -289,7 +289,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
 
     但是，dotenv 文件实际上不一定要具有确切的文件名。
 
-Pydantic 支持使用外部库从这些类型的文件中读取。您可以在<a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic 设置: Dotenv (.env) 支持</a>中阅读更多相关信息。
+Pydantic 支持使用外部库从这些类型的文件中读取。您可以在<a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic 设置: Dotenv (.env) 支持</a>中阅读更多相关信息。
 
 !!! tip
     要使其工作，您需要执行 `pip install python-dotenv`。
@@ -337,7 +337,7 @@ def get_settings():
 
 我们将为每个请求创建该对象，并且将在每个请求中读取 `.env` 文件。 ⚠️
 
-但是，由于我们在顶部使用了 `@lru_cache()` 装饰器，因此只有在第一次调用它时，才会创建 `Settings` 对象一次。 ✔️
+但是，由于我们在顶部使用了 `@lru_cache` 装饰器，因此只有在第一次调用它时，才会创建 `Settings` 对象一次。 ✔️
 
 === "Python 3.9+"
 
@@ -345,13 +345,13 @@ def get_settings():
     {!> ../../../docs_src/settings/app03_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  11"
     {!> ../../../docs_src/settings/app03_an/main.py!}
     ```
 
-=== "Python 3.6+ 非注解版本"
+=== "Python 3.8+ 非注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -364,13 +364,13 @@ def get_settings():
 
 #### `lru_cache` 技术细节
 
-`@lru_cache()` 修改了它所装饰的函数，以返回第一次返回的相同值，而不是再次计算它，每次都执行函数的代码。
+`@lru_cache` 修改了它所装饰的函数，以返回第一次返回的相同值，而不是再次计算它，每次都执行函数的代码。
 
 因此，下面的函数将对每个参数组合执行一次。然后，每个参数组合返回的值将在使用完全相同的参数组合调用函数时再次使用。
 
 例如，如果您有一个函数：
 ```Python
-@lru_cache()
+@lru_cache
 def say_hi(name: str, salutation: str = "Ms."):
     return f"Hello {salutation} {name}"
 ```
@@ -422,7 +422,7 @@ participant execute as Execute function
 
 这样，它的行为几乎就像是一个全局变量。但是由于它使用了依赖项函数，因此我们可以轻松地进行测试时的覆盖。
 
-`@lru_cache()` 是 `functools` 的一部分，它是 Python 标准库的一部分，您可以在<a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python 文档中了解有关 `@lru_cache()` 的更多信息</a>。
+`@lru_cache` 是 `functools` 的一部分，它是 Python 标准库的一部分，您可以在<a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python 文档中了解有关 `@lru_cache` 的更多信息</a>。
 
 ## 小结
 
@@ -430,4 +430,4 @@ participant execute as Execute function
 
 * 通过使用依赖项，您可以简化测试。
 * 您可以使用 `.env` 文件。
-* 使用 `@lru_cache()` 可以避免为每个请求重复读取 dotenv 文件，同时允许您在测试时进行覆盖。
+* 使用 `@lru_cache` 可以避免为每个请求重复读取 dotenv 文件，同时允许您在测试时进行覆盖。
diff --git a/docs/zh/docs/advanced/websockets.md b/docs/zh/docs/advanced/websockets.md
index a723487fd..a5cbdd965 100644
--- a/docs/zh/docs/advanced/websockets.md
+++ b/docs/zh/docs/advanced/websockets.md
@@ -118,7 +118,7 @@ $ uvicorn main:app --reload
     {!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="69-70  83"
     {!> ../../../docs_src/websockets/tutorial002_an.py!}
@@ -133,7 +133,7 @@ $ uvicorn main:app --reload
     {!> ../../../docs_src/websockets/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ 非带注解版本"
+=== "Python 3.8+ 非带注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -181,7 +181,7 @@ $ uvicorn main:app --reload
     {!> ../../../docs_src/websockets/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="81-83"
     {!> ../../../docs_src/websockets/tutorial003.py!}
diff --git a/docs/zh/docs/async.md b/docs/zh/docs/async.md
new file mode 100644
index 000000000..59eebd049
--- /dev/null
+++ b/docs/zh/docs/async.md
@@ -0,0 +1,430 @@
+# 并发 async / await
+
+有关路径操作函数的 `async def` 语法以及异步代码、并发和并行的一些背景知识。
+
+## 赶时间吗？
+
+<abbr title="too long; didn't read(长文警告)"><strong>TL;DR:</strong></abbr>
+
+如果你正在使用第三方库，它们会告诉你使用 `await` 关键字来调用它们，就像这样：
+
+```Python
+results = await some_library()
+```
+
+然后，通过 `async def` 声明你的 *路径操作函数*：
+
+```Python hl_lines="2"
+@app.get('/')
+async def read_results():
+    results = await some_library()
+    return results
+```
+
+!!! note
+    你只能在被 `async def` 创建的函数内使用 `await`
+
+---
+
+如果你正在使用一个第三方库和某些组件（比如：数据库、API、文件系统...）进行通信，第三方库又不支持使用 `await` （目前大多数数据库三方库都是这样），这种情况你可以像平常那样使用 `def` 声明一个路径操作函数，就像这样：
+
+```Python hl_lines="2"
+@app.get('/')
+def results():
+    results = some_library()
+    return results
+```
+
+---
+
+如果你的应用程序不需要与其他任何东西通信而等待其响应，请使用 `async def`。
+
+---
+
+如果你不清楚，使用 `def` 就好.
+
+---
+
+**注意**：你可以根据需要在路径操作函数中混合使用 `def` 和 `async def`，并使用最适合你的方式去定义每个函数。FastAPI 将为他们做正确的事情。
+
+无论如何，在上述任何情况下，FastAPI 仍将异步工作，速度也非常快。
+
+但是，通过遵循上述步骤，它将能够进行一些性能优化。
+
+## 技术细节
+
+Python 的现代版本支持通过一种叫**"协程"**——使用 `async` 和 `await` 语法的东西来写**”异步代码“**。
+
+让我们在下面的部分中逐一介绍：
+
+* **异步代码**
+* **`async` 和 `await`**
+* **协程**
+
+## 异步代码
+
+异步代码仅仅意味着编程语言 💬 有办法告诉计算机/程序 🤖 在代码中的某个点，它 🤖 将不得不等待在某些地方完成一些事情。让我们假设一些事情被称为 "慢文件"📝.
+
+所以，在等待"慢文件"📝完成的这段时间，计算机可以做一些其他工作。
+
+然后计算机/程序 🤖 每次有机会都会回来，因为它又在等待，或者它 🤖 完成了当前所有的工作。而且它 🤖 将查看它等待的所有任务中是否有已经完成的，做它必须做的任何事情。
+
+接下来，它 🤖 完成第一个任务（比如是我们的"慢文件"📝) 并继续与之相关的一切。
+
+这个"等待其他事情"通常指的是一些相对较慢（与处理器和 RAM 存储器的速度相比）的 <abbr title="Input and Output">I/O</abbr> 操作，比如说：
+
+* 通过网络发送来自客户端的数据
+* 客户端接收来自网络中的数据
+* 磁盘中要由系统读取并提供给程序的文件的内容
+* 程序提供给系统的要写入磁盘的内容
+* 一个 API 的远程调用
+* 一个数据库操作，直到完成
+* 一个数据库查询，直到返回结果
+* 等等.
+
+这个执行的时间大多是在等待 <abbr title="Input and Output">I/O</abbr> 操作，因此它们被叫做 "I/O 密集型" 操作。
+
+它被称为"异步"的原因是因为计算机/程序不必与慢任务"同步"，去等待任务完成的确切时刻，而在此期间不做任何事情直到能够获取任务结果才继续工作。
+
+相反，作为一个"异步"系统，一旦完成，任务就可以排队等待一段时间（几微秒），等待计算机程序完成它要做的任何事情，然后回来获取结果并继续处理它们。
+
+对于"同步"（与"异步"相反），他们通常也使用"顺序"一词，因为计算机程序在切换到另一个任务之前是按顺序执行所有步骤，即使这些步骤涉及到等待。
+
+### 并发与汉堡
+
+上述异步代码的思想有时也被称为“并发”，它不同于“并行”。
+
+并发和并行都与“不同的事情或多或少同时发生”有关。
+
+但是并发和并行之间的细节是完全不同的。
+
+要了解差异，请想象以下关于汉堡的故事：
+
+### 并发汉堡
+
+你和你的恋人一起去快餐店，你排队在后面，收银员从你前面的人接单。😍
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-01.png" class="illustration">
+
+然后轮到你了，你为你的恋人和你选了两个非常豪华的汉堡。🍔🍔
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-02.png" class="illustration">
+
+收银员对厨房里的厨师说了一些话，让他们知道他们必须为你准备汉堡（尽管他们目前正在为之前的顾客准备汉堡）。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-03.png" class="illustration">
+
+你付钱了。 💸
+
+收银员给你轮到的号码。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-04.png" class="illustration">
+
+当你在等待的时候，你和你的恋人一起去挑选一张桌子，然后你们坐下来聊了很长时间（因为汉堡很豪华，需要一些时间来准备）。
+
+当你和你的恋人坐在桌子旁，等待汉堡的时候，你可以用这段时间来欣赏你的恋人是多么的棒、可爱和聪明✨😍✨。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-05.png" class="illustration">
+
+在等待中和你的恋人交谈时，你会不时地查看柜台上显示的号码，看看是否已经轮到你了。
+
+然后在某个时刻，终于轮到你了。你去柜台拿汉堡然后回到桌子上。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-06.png" class="illustration">
+
+你们享用了汉堡，整个过程都很开心。✨
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-07.png" class="illustration">
+
+!!! info
+    漂亮的插画来自 <a href="https://www.instagram.com/ketrinadrawsalot" class="external-link" target="_blank">Ketrina Thompson</a>. 🎨
+
+---
+
+在那个故事里，假设你是计算机程序 🤖 。
+
+当你在排队时，你只是闲着😴， 轮到你前不做任何事情（仅排队）。但排队很快，因为收银员只接订单（不准备订单），所以这一切都还好。
+
+然后，当轮到你时，需要你做一些实际性的工作，比如查看菜单，决定你想要什么，让你的恋人选择，支付，检查你是否提供了正确的账单或卡，检查你的收费是否正确，检查订单是否有正确的项目，等等。
+
+此时，即使你仍然没有汉堡，你和收银员的工作也"暂停"了⏸， 因为你必须等待一段时间 🕙 让你的汉堡做好。
+
+但是，当你离开柜台并坐在桌子旁，在轮到你的号码前的这段时间，你可以将焦点切换到 🔀 你的恋人上，并做一些"工作"⏯ 🤓。你可以做一些非常"有成效"的事情，比如和你的恋人调情😍.
+
+之后，收银员 💁 把号码显示在显示屏上，并说到 "汉堡做好了"，而当显示的号码是你的号码时，你不会立刻疯狂地跳起来。因为你知道没有人会偷你的汉堡，因为你有你的号码，而其他人又有他们自己的号码。
+
+所以你要等待你的恋人完成故事（完成当前的工作⏯ /正在做的事🤓)， 轻轻微笑，说你要吃汉堡⏸.
+
+然后你去柜台🔀， 到现在初始任务已经完成⏯， 拿起汉堡，说声谢谢，然后把它们送到桌上。这就完成了与计数器交互的步骤/任务⏹. 这反过来又产生了一项新任务，即"吃汉堡"🔀 ⏯， 上一个"拿汉堡"的任务已经结束了⏹.
+
+### 并行汉堡
+
+现在让我们假设不是"并发汉堡"，而是"并行汉堡"。
+
+你和你的恋人一起去吃并行快餐。
+
+你站在队伍中，同时是厨师的几个收银员（比方说8个）从前面的人那里接单。
+
+你之前的每个人都在等待他们的汉堡准备好后才离开柜台，因为8名收银员都会在下一份订单前马上准备好汉堡。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-01.png" class="illustration">
+
+然后，终于轮到你了，你为你的恋人和你订购了两个非常精美的汉堡。
+
+你付钱了 💸。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-02.png" class="illustration">
+
+收银员去厨房。
+
+你站在柜台前 🕙等待着，这样就不会有人在你之前抢走你的汉堡，因为没有轮流的号码。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-03.png" class="illustration">
+
+当你和你的恋人忙于不让任何人出现在你面前，并且在他们到来的时候拿走你的汉堡时，你无法关注到你的恋人。😞
+
+这是"同步"的工作，你被迫与服务员/厨师 👨‍🍳"同步"。你在此必须等待 🕙 ，在收银员/厨师 👨‍🍳 完成汉堡并将它们交给你的确切时间到达之前一直等待，否则其他人可能会拿走它们。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-04.png" class="illustration">
+
+你经过长时间的等待 🕙 ，收银员/厨师 👨‍🍳终于带着汉堡回到了柜台。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-05.png" class="illustration">
+
+你拿着汉堡，和你的情人一起上桌。
+
+你们仅仅是吃了它们，就结束了。⏹
+
+<img src="/img/async/parallel-burgers/parallel-burgers-06.png" class="illustration">
+
+没有太多的交谈或调情，因为大部分时间 🕙 都在柜台前等待😞。
+
+!!! info
+    漂亮的插画来自 <a href="https://www.instagram.com/ketrinadrawsalot" class="external-link" target="_blank">Ketrina Thompson</a>. 🎨
+
+---
+
+在这个并行汉堡的场景中，你是一个计算机程序 🤖 且有两个处理器（你和你的恋人），都在等待 🕙 ，并投入他们的注意力 ⏯ 在柜台上等待了很长一段时间。
+
+这家快餐店有 8 个处理器（收银员/厨师）。而并发汉堡店可能只有 2 个（一个收银员和一个厨师）。
+
+但最终的体验仍然不是最好的。😞
+
+---
+
+这将是与汉堡的类似故事。🍔
+
+一种更"贴近生活"的例子，想象一家银行。
+
+直到最近，大多数银行都有多个出纳员 👨‍💼👨‍💼👨‍💼👨‍💼 还有一条长长排队队伍🕙🕙🕙🕙🕙🕙🕙🕙。
+
+所有收银员都是一个接一个的在客户面前做完所有的工作👨‍💼⏯.
+
+你必须经过 🕙 较长时间排队，否则你就没机会了。
+
+你可不会想带你的恋人 😍 和你一起去银行办事🏦.
+
+### 汉堡结论
+
+在"你与恋人一起吃汉堡"的这个场景中，因为有很多人在等待🕙， 使用并发系统更有意义⏸🔀⏯.
+
+大多数 Web 应用都是这样的。
+
+你的服务器正在等待很多很多用户通过他们不太好的网络发送来的请求。
+
+然后再次等待 🕙 响应回来。
+
+这个"等待" 🕙 是以微秒为单位测量的，但总的来说，最后还是等待很久。
+
+这就是为什么使用异步对于 Web API 很有意义的原因 ⏸🔀⏯。
+
+这种异步机制正是 NodeJS 受到欢迎的原因（尽管 NodeJS 不是并行的），以及 Go 作为编程语言的优势所在。
+
+这与 **FastAPI** 的性能水平相同。
+
+您可以同时拥有并行性和异步性，您可以获得比大多数经过测试的 NodeJS 框架更高的性能，并且与 Go 不相上下， Go 是一种更接近于 C 的编译语言（<a href="https://www.techempower.com/benchmarks/#section=data-r17&hw=ph&test=query&l=zijmkf-1" class="external-link" target="_blank">全部归功于 Starlette</a>）。
+
+### 并发比并行好吗？
+
+不！这不是故事的本意。
+
+并发不同于并行。而是在需要大量等待的特定场景下效果更好。因此，在 Web 应用程序开发中，它通常比并行要好得多，但这并不意味着全部。
+
+因此，为了平衡这一点，想象一下下面的短篇故事：
+
+> 你必须打扫一个又大又脏的房子。
+
+*是的，这就是完整的故事。*
+
+---
+
+在任何地方， 都不需要等待 🕙 ，只需要在房子的多个地方做着很多工作。
+
+你可以像汉堡的例子那样轮流执行，先是客厅，然后是厨房，但因为你不需要等待 🕙 ，对于任何事情都是清洁，清洁，还是清洁，轮流不会影响任何事情。
+
+无论是否轮流执行（并发），都需要相同的时间来完成，而你也会完成相同的工作量。
+
+但在这种情况下，如果你能带上 8 名前收银员/厨师，现在是清洁工一起清扫，他们中的每一个人（加上你）都能占据房子的一个区域来清扫，你就可以在额外的帮助下并行的更快地完成所有工作。
+
+在这个场景中，每个清洁工（包括您）都将是一个处理器，完成这个工作的一部分。
+
+由于大多数执行时间是由实际工作（而不是等待）占用的，并且计算机中的工作是由 <abbr title="Central Processing Unit">CPU</abbr> 完成的，所以他们称这些问题为"CPU 密集型"。
+
+---
+
+CPU 密集型操作的常见示例是需要复杂的数学处理。
+
+例如：
+
+* **音频**或**图像**处理；
+* **计算机视觉**: 一幅图像由数百万像素组成，每个像素有3种颜色值，处理通常需要同时对这些像素进行计算；
+* **机器学习**: 它通常需要大量的"矩阵"和"向量"乘法。想象一个包含数字的巨大电子表格，并同时将所有数字相乘；
+* **深度学习**: 这是机器学习的一个子领域，同样适用。只是没有一个数字的电子表格可以相乘，而是一个庞大的数字集合，在很多情况下，你需要使用一个特殊的处理器来构建和使用这些模型。
+
+### 并发 + 并行: Web + 机器学习
+
+使用 **FastAPI**，您可以利用 Web 开发中常见的并发机制的优势（NodeJS 的主要吸引力）。
+
+并且，您也可以利用并行和多进程（让多个进程并行运行）的优点来处理与机器学习系统中类似的 **CPU 密集型** 工作。
+
+这一点，再加上 Python 是**数据科学**、机器学习（尤其是深度学习）的主要语言这一简单事实，使得 **FastAPI** 与数据科学/机器学习 Web API 和应用程序（以及其他许多应用程序）非常匹配。
+
+了解如何在生产环境中实现这种并行性，可查看此文 [Deployment](deployment/index.md){.internal-link target=_blank}。
+
+## `async` 和 `await`
+
+现代版本的 Python 有一种非常直观的方式来定义异步代码。这使它看起来就像正常的"顺序"代码，并在适当的时候"等待"。
+
+当有一个操作需要等待才能给出结果，且支持这个新的 Python 特性时，您可以编写如下代码：
+
+```Python
+burgers = await get_burgers(2)
+```
+
+这里的关键是 `await`。它告诉 Python 它必须等待 ⏸ `get_burgers(2)` 完成它的工作 🕙 ，然后将结果存储在 `burgers` 中。这样，Python 就会知道此时它可以去做其他事情 🔀 ⏯ （比如接收另一个请求）。
+
+要使 `await` 工作，它必须位于支持这种异步机制的函数内。因此，只需使用 `async def` 声明它：
+
+```Python hl_lines="1"
+async def get_burgers(number: int):
+    # Do some asynchronous stuff to create the burgers
+    return burgers
+```
+
+...而不是 `def`:
+
+```Python hl_lines="2"
+# This is not asynchronous
+def get_sequential_burgers(number: int):
+    # Do some sequential stuff to create the burgers
+    return burgers
+```
+
+使用 `async def`，Python 就知道在该函数中，它将遇上 `await`，并且它可以"暂停" ⏸ 执行该函数，直至执行其他操作 🔀 后回来。
+
+当你想调用一个 `async def` 函数时，你必须"等待"它。因此，这不会起作用：
+
+```Python
+# This won't work, because get_burgers was defined with: async def
+burgers = get_burgers(2)
+```
+
+---
+
+因此，如果您使用的库告诉您可以使用 `await` 调用它，则需要使用 `async def` 创建路径操作函数 ，如：
+
+```Python hl_lines="2-3"
+@app.get('/burgers')
+async def read_burgers():
+    burgers = await get_burgers(2)
+    return burgers
+```
+
+### 更多技术细节
+
+您可能已经注意到，`await` 只能在 `async def` 定义的函数内部使用。
+
+但与此同时，必须"等待"通过 `async def` 定义的函数。因此，带 `async def` 的函数也只能在 `async def` 定义的函数内部调用。
+
+那么，这关于先有鸡还是先有蛋的问题，如何调用第一个 `async` 函数？
+
+如果您使用 **FastAPI**，你不必担心这一点，因为"第一个"函数将是你的路径操作函数，FastAPI 将知道如何做正确的事情。
+
+但如果您想在没有 FastAPI 的情况下使用 `async` / `await`，则可以这样做。
+
+### 编写自己的异步代码
+
+Starlette （和 **FastAPI**） 是基于 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a> 实现的，这使得它们可以兼容 Python 的标准库 <a href="https://docs.python.org/3/library/asyncio-task.html" class="external-link" target="_blank">asyncio</a> 和 <a href="https://trio.readthedocs.io/en/stable/" class="external-link" target="_blank">Trio</a>。
+
+特别是，你可以直接使用 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a> 来处理高级的并发用例，这些用例需要在自己的代码中使用更高级的模式。
+
+即使您没有使用 **FastAPI**，您也可以使用 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a> 编写自己的异步程序，使其拥有较高的兼容性并获得一些好处（例如， 结构化并发）。
+
+### 其他形式的异步代码
+
+这种使用 `async` 和 `await` 的风格在语言中相对较新。
+
+但它使处理异步代码变得容易很多。
+
+这种相同的语法（或几乎相同）最近也包含在现代版本的 JavaScript 中（在浏览器和 NodeJS 中）。
+
+但在此之前，处理异步代码非常复杂和困难。
+
+在以前版本的 Python，你可以使用多线程或者 <a href="https://www.gevent.org/" class="external-link" target="_blank">Gevent</a>。但代码的理解、调试和思考都要复杂许多。
+
+在以前版本的 NodeJS / 浏览器 JavaScript 中，你会使用"回调"，因此也可能导致<a href="http://callbackhell.com/" class="external-link" target="_blank">回调地狱</a>。
+
+## 协程
+
+**协程**只是 `async def` 函数返回的一个非常奇特的东西的称呼。Python 知道它有点像一个函数，它可以启动，也会在某个时刻结束，而且它可能会在内部暂停 ⏸ ，只要内部有一个 `await`。
+
+通过使用 `async` 和 `await` 的异步代码的所有功能大多数被概括为"协程"。它可以与 Go 的主要关键特性 "Goroutines" 相媲美。
+
+## 结论
+
+让我们再来回顾下上文所说的：
+
+> Python 的现代版本可以通过使用 `async` 和 `await` 语法创建**协程**，并用于支持**异步代码**。
+
+现在应该能明白其含义了。✨
+
+所有这些使得 FastAPI（通过 Starlette）如此强大，也是它拥有如此令人印象深刻的性能的原因。
+
+## 非常技术性的细节
+
+!!! warning
+    你可以跳过这里。
+
+    这些都是 FastAPI 如何在内部工作的技术细节。
+
+    如果您有相当多的技术知识（协程、线程、阻塞等），并且对 FastAPI 如何处理 `async def` 与常规 `def` 感到好奇，请继续。
+
+### 路径操作函数
+
+当你使用 `def` 而不是 `async def` 来声明一个*路径操作函数*时，它运行在外部的线程池中并等待其结果，而不是直接调用（因为它会阻塞服务器）。
+
+如果您使用过另一个不以上述方式工作的异步框架，并且您习惯于用普通的 `def` 定义普通的仅计算路径操作函数，以获得微小的性能增益（大约100纳秒），请注意，在 FastAPI 中，效果将完全相反。在这些情况下，最好使用 `async def`，除非路径操作函数内使用执行阻塞 <abbr title="输入/输出：磁盘读写，网络通讯.">I/O</abbr> 的代码。
+
+在这两种情况下，与您之前的框架相比，**FastAPI** 可能[仍然很快](/#performance){.internal-link target=_blank}。
+
+### 依赖
+
+这同样适用于[依赖](./tutorial/dependencies/index.md){.internal-link target=_blank}。如果一个依赖是标准的 `def` 函数而不是 `async def`，它将被运行在外部线程池中。
+
+### 子依赖
+
+你可以拥有多个相互依赖的依赖以及[子依赖](./tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} （作为函数的参数），它们中的一些可能是通过 `async def` 声明，也可能是通过 `def` 声明。它们仍然可以正常工作，这些通过 `def` 声明的函数将会在外部线程中调用（来自线程池），而不是"被等待"。
+
+### 其他函数
+
+您可直接调用通过 `def` 或 `async def` 创建的任何其他函数，FastAPI 不会影响您调用它们的方式。
+
+这与 FastAPI 为您调用*路径操作函数*和依赖项的逻辑相反。
+
+如果你的函数是通过 `def` 声明的，它将被直接调用（在代码中编写的地方），而不会在线程池中，如果这个函数通过 `async def` 声明，当在代码中调用时，你就应该使用 `await` 等待函数的结果。
+
+---
+
+再次提醒，这些是非常技术性的细节，如果你来搜索它可能对你有用。
+
+否则，您最好应该遵守的指导原则<a href="#_1">赶时间吗？</a>.
diff --git a/docs/zh/docs/deployment/versions.md b/docs/zh/docs/deployment/versions.md
new file mode 100644
index 000000000..75b870139
--- /dev/null
+++ b/docs/zh/docs/deployment/versions.md
@@ -0,0 +1,87 @@
+# 关于 FastAPI 版本
+
+**FastAPI** 已在许多应用程序和系统的生产环境中使用。 并且测试覆盖率保持在100%。 但其开发进度仍在快速推进。
+
+经常添加新功能，定期修复错误，并且代码仍在持续改进。
+
+这就是为什么当前版本仍然是`0.x.x`，这反映出每个版本都可能有Breaking changes。 这遵循<a href="https://semver.org/" class="external-link" target="_blank">语义版本控制</a>的约定。
+
+你现在就可以使用 **FastAPI** 创建生产环境应用程序（你可能已经这样做了一段时间），你只需确保使用的版本可以与其余代码正确配合即可。
+
+## 固定你的 `fastapi` 版本
+
+你应该做的第一件事是将你正在使用的 **FastAPI** 版本“固定”到你知道适用于你的应用程序的特定最新版本。
+
+例如，假设你在应用程序中使用版本`0.45.0`。
+
+如果你使用`requirements.txt`文件，你可以使用以下命令指定版本：
+
+````txt
+fastapi==0.45.0
+````
+
+这意味着你将使用版本`0.45.0`。
+
+或者你也可以将其固定为：
+
+````txt
+fastapi>=0.45.0,<0.46.0
+````
+
+这意味着你将使用`0.45.0`或更高版本，但低于`0.46.0`，例如，版本`0.45.2`仍会被接受。
+
+如果你使用任何其他工具来管理你的安装，例如 Poetry、Pipenv 或其他工具，它们都有一种定义包的特定版本的方法。
+
+## 可用版本
+
+你可以在[发行说明](../release-notes.md){.internal-link target=_blank}中查看可用版本（例如查看当前最新版本）。
+
+## 关于版本
+
+遵循语义版本控制约定，任何低于`1.0.0`的版本都可能会添加 breaking changes。
+
+FastAPI 还遵循这样的约定：任何`PATCH`版本更改都是为了bug修复和non-breaking changes。
+
+!!! tip
+     "PATCH"是最后一个数字，例如，在`0.2.3`中，PATCH版本是`3`。
+
+因此，你应该能够固定到如下版本：
+
+```txt
+fastapi>=0.45.0,<0.46.0
+```
+
+"MINOR"版本中会添加breaking changes和新功能。
+
+!!! tip
+     "MINOR"是中间的数字，例如，在`0.2.3`中，MINOR版本是`2`。
+
+## 升级FastAPI版本
+
+你应该为你的应用程序添加测试。
+
+使用 **FastAPI** 编写测试非常简单（感谢 Starlette），请参考文档：[测试](../tutorial/testing.md){.internal-link target=_blank}
+
+添加测试后，你可以将 **FastAPI** 版本升级到更新版本，并通过运行测试来确保所有代码都能正常工作。
+
+如果一切正常，或者在进行必要的更改之后，并且所有测试都通过了，那么你可以将`fastapi`固定到新的版本。
+
+## 关于Starlette
+
+你不应该固定`starlette`的版本。
+
+不同版本的 **FastAPI** 将使用特定的较新版本的 Starlette。
+
+因此，**FastAPI** 自己可以使用正确的 Starlette 版本。
+
+## 关于 Pydantic
+
+Pydantic 包含针对 **FastAPI** 的测试及其自己的测试，因此 Pydantic 的新版本（`1.0.0`以上）始终与 FastAPI 兼容。
+
+你可以将 Pydantic 固定到适合你的`1.0.0`以上和`2.0.0`以下的任何版本。
+
+例如：
+
+````txt
+pydantic>=1.2.0,<2.0.0
+````
diff --git a/docs/zh/docs/help-fastapi.md b/docs/zh/docs/help-fastapi.md
index 2a99950e3..9b70d115a 100644
--- a/docs/zh/docs/help-fastapi.md
+++ b/docs/zh/docs/help-fastapi.md
@@ -114,8 +114,6 @@
 
     聊天室仅供闲聊。
 
-我们之前还使用过 <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">Gitter chat</a>，但它不支持频道等高级功能，聊天也比较麻烦，所以现在推荐使用 Discord。
-
 ### 别在聊天室里提问
 
 注意，聊天室更倾向于“闲聊”，经常有人会提出一些笼统得让人难以回答的问题，所以在这里提问一般没人回答。
diff --git a/docs/zh/docs/index.md b/docs/zh/docs/index.md
index 1de2a8d36..d776e5813 100644
--- a/docs/zh/docs/index.md
+++ b/docs/zh/docs/index.md
@@ -24,7 +24,7 @@
 
 ---
 
-FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框架，使用 Python 3.6+ 并基于标准的 Python 类型提示。
+FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框架，使用 Python 3.8+ 并基于标准的 Python 类型提示。
 
 关键特性:
 
@@ -107,7 +107,7 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框
 
 ## 依赖
 
-Python 3.6 及更高版本
+Python 3.8 及更高版本
 
 FastAPI 站在以下巨人的肩膀之上：
 
@@ -323,7 +323,7 @@ def update_item(item_id: int, item: Item):
 
 你不需要去学习新的语法、了解特定库的方法或类，等等。
 
-只需要使用标准的 **Python 3.6 及更高版本**。
+只需要使用标准的 **Python 3.8 及更高版本**。
 
 举个例子，比如声明 `int` 类型：
 
diff --git a/docs/zh/docs/tutorial/background-tasks.md b/docs/zh/docs/tutorial/background-tasks.md
new file mode 100644
index 000000000..94b75d4fd
--- /dev/null
+++ b/docs/zh/docs/tutorial/background-tasks.md
@@ -0,0 +1,126 @@
+# 后台任务
+
+你可以定义在返回响应后运行的后台任务。
+
+这对需要在请求之后执行的操作很有用，但客户端不必在接收响应之前等待操作完成。
+
+包括这些例子：
+
+* 执行操作后发送的电子邮件通知：
+    * 由于连接到电子邮件服务器并发送电子邮件往往很“慢”（几秒钟），您可以立即返回响应并在后台发送电子邮件通知。
+* 处理数据：
+    * 例如，假设您收到的文件必须经过一个缓慢的过程，您可以返回一个"Accepted"(HTTP 202)响应并在后台处理它。
+
+## 使用 `BackgroundTasks`
+
+首先导入 `BackgroundTasks` 并在 *路径操作函数* 中使用类型声明 `BackgroundTasks` 定义一个参数：
+
+```Python hl_lines="1  13"
+{!../../../docs_src/background_tasks/tutorial001.py!}
+```
+
+**FastAPI** 会创建一个 `BackgroundTasks` 类型的对象并作为该参数传入。
+
+## 创建一个任务函数
+
+创建要作为后台任务运行的函数。
+
+它只是一个可以接收参数的标准函数。
+
+它可以是 `async def` 或普通的 `def` 函数，**FastAPI** 知道如何正确处理。
+
+在这种情况下，任务函数将写入一个文件（模拟发送电子邮件）。
+
+由于写操作不使用 `async` 和 `await`，我们用普通的 `def` 定义函数：
+
+```Python hl_lines="6-9"
+{!../../../docs_src/background_tasks/tutorial001.py!}
+```
+
+## 添加后台任务
+
+在你的 *路径操作函数* 里，用 `.add_task()` 方法将任务函数传到 *后台任务* 对象中：
+
+```Python hl_lines="14"
+{!../../../docs_src/background_tasks/tutorial001.py!}
+```
+
+`.add_task()` 接收以下参数：
+
+* 在后台运行的任务函数(`write_notification`)。
+* 应按顺序传递给任务函数的任意参数序列(`email`)。
+* 应传递给任务函数的任意关键字参数(`message="some notification"`)。
+
+## 依赖注入
+
+使用 `BackgroundTasks` 也适用于依赖注入系统，你可以在多个级别声明 `BackgroundTasks` 类型的参数：在 *路径操作函数* 里，在依赖中(可依赖)，在子依赖中，等等。
+
+**FastAPI** 知道在每种情况下该做什么以及如何复用同一对象，因此所有后台任务被合并在一起并且随后在后台运行：
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="13  15  22  25"
+    {!> ../../../docs_src/background_tasks/tutorial002_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="13  15  22  25"
+    {!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="14  16  23  26"
+    {!> ../../../docs_src/background_tasks/tutorial002_an.py!}
+    ```
+
+=== "Python 3.10+ 没Annotated"
+
+    !!! tip
+         尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="11  13  20  23"
+    {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+ 没Annotated"
+
+    !!! tip
+         尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="13  15  22  25"
+    {!> ../../../docs_src/background_tasks/tutorial002.py!}
+    ```
+
+该示例中，信息会在响应发出 *之后* 被写到 `log.txt` 文件。
+
+如果请求中有查询，它将在后台任务中写入日志。
+
+然后另一个在 *路径操作函数* 生成的后台任务会使用路径参数 `email` 写入一条信息。
+
+## 技术细节
+
+`BackgroundTasks` 类直接来自 <a href="https://www.starlette.io/background/" class="external-link" target="_blank">`starlette.background`</a>。
+
+它被直接导入/包含到FastAPI以便你可以从 `fastapi` 导入，并避免意外从 `starlette.background` 导入备用的 `BackgroundTask` (后面没有 `s`)。
+
+通过仅使用 `BackgroundTasks` (而不是 `BackgroundTask`)，使得能将它作为 *路径操作函数* 的参数 ，并让**FastAPI**为您处理其余部分, 就像直接使用 `Request` 对象。
+
+在FastAPI中仍然可以单独使用 `BackgroundTask`，但您必须在代码中创建对象，并返回包含它的Starlette `Response`。
+
+更多细节查看 <a href="https://www.starlette.io/background/" class="external-link" target="_blank">Starlette's official docs for Background Tasks</a>.
+
+## 告诫
+
+如果您需要执行繁重的后台计算，并且不一定需要由同一进程运行（例如，您不需要共享内存、变量等），那么使用其他更大的工具（如 <a href="https://docs.celeryq.dev" class="external-link" target="_blank">Celery</a>）可能更好。
+
+它们往往需要更复杂的配置，即消息/作业队列管理器，如RabbitMQ或Redis，但它们允许您在多个进程中运行后台任务，甚至是在多个服务器中。
+
+要查看示例，查阅 [Project Generators](../project-generation.md){.internal-link target=_blank}，它们都包括已经配置的Celery。
+
+但是，如果您需要从同一个**FastAPI**应用程序访问变量和对象，或者您需要执行小型后台任务（如发送电子邮件通知），您只需使用 `BackgroundTasks` 即可。
+
+## 回顾
+
+导入并使用 `BackgroundTasks` 通过 *路径操作函数* 中的参数和依赖项来添加后台任务。
diff --git a/docs/zh/docs/tutorial/body-fields.md b/docs/zh/docs/tutorial/body-fields.md
index 053cae71c..fb6c6d9b6 100644
--- a/docs/zh/docs/tutorial/body-fields.md
+++ b/docs/zh/docs/tutorial/body-fields.md
@@ -6,9 +6,41 @@
 
 首先，你必须导入它：
 
-```Python hl_lines="2"
-{!../../../docs_src/body_fields/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001.py!}
+    ```
 
 !!! warning
     注意，`Field` 是直接从 `pydantic` 导入的，而不是像其他的（`Query`，`Path`，`Body` 等）都从 `fastapi` 导入。
@@ -17,9 +49,41 @@
 
 然后，你可以对模型属性使用 `Field`：
 
-```Python hl_lines="9-10"
-{!../../../docs_src/body_fields/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="12-15"
+    {!> ../../../docs_src/body_fields/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="9-12"
+    {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001.py!}
+    ```
 
 `Field` 的工作方式和 `Query`、`Path` 和 `Body` 相同，包括它们的参数等等也完全相同。
 
diff --git a/docs/zh/docs/tutorial/body-multiple-params.md b/docs/zh/docs/tutorial/body-multiple-params.md
index 34fa5b638..c93ef2f5c 100644
--- a/docs/zh/docs/tutorial/body-multiple-params.md
+++ b/docs/zh/docs/tutorial/body-multiple-params.md
@@ -8,9 +8,41 @@
 
 你还可以通过将默认值设置为 `None` 来将请求体参数声明为可选参数：
 
-```Python hl_lines="17-19"
-{!../../../docs_src/body_multiple_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18-20"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="18-20"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="19-21"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="17-19"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="19-21"
+    {!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+    ```
 
 !!! note
     请注意，在这种情况下，将从请求体获取的 `item` 是可选的。因为它的默认值为 `None`。
@@ -30,9 +62,17 @@
 
 但是你也可以声明多个请求体参数，例如 `item` 和 `user`：
 
-```Python hl_lines="20"
-{!../../../docs_src/body_multiple_params/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+    ```
 
 在这种情况下，**FastAPI** 将注意到该函数中有多个请求体参数（两个 Pydantic 模型参数）。
 
@@ -72,9 +112,41 @@
 但是你可以使用 `Body` 指示 **FastAPI** 将其作为请求体的另一个键进行处理。
 
 
-```Python hl_lines="22"
-{!../../../docs_src/body_multiple_params/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="23"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="23"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="24"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+    ```
 
 在这种情况下，**FastAPI** 将期望像这样的请求体：
 
@@ -109,9 +181,41 @@ q: str = None
 
 比如：
 
-```Python hl_lines="25"
-{!../../../docs_src/body_multiple_params/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="27"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="27"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="28"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="25"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="27"
+    {!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+    ```
 
 !!! info
     `Body` 同样具有与 `Query`、`Path` 以及其他后面将看到的类完全相同的额外校验和元数据参数。
@@ -131,9 +235,41 @@ item: Item = Body(embed=True)
 
 比如：
 
-```Python hl_lines="15"
-{!../../../docs_src/body_multiple_params/tutorial005.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+    ```
 
 在这种情况下，**FastAPI** 将期望像这样的请求体：
 
diff --git a/docs/zh/docs/tutorial/body-nested-models.md b/docs/zh/docs/tutorial/body-nested-models.md
index 7649ee6fe..c65308bef 100644
--- a/docs/zh/docs/tutorial/body-nested-models.md
+++ b/docs/zh/docs/tutorial/body-nested-models.md
@@ -6,9 +6,17 @@
 
 你可以将一个属性定义为拥有子元素的类型。例如 Python `list`：
 
-```Python hl_lines="12"
-{!../../../docs_src/body_nested_models/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial001.py!}
+    ```
 
 这将使 `tags` 成为一个由元素组成的列表。不过它没有声明每个元素的类型。
 
@@ -21,7 +29,7 @@
 首先，从 Python 的标准库 `typing` 模块中导入 `List`：
 
 ```Python hl_lines="1"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../../docs_src/body_nested_models/tutorial002.py!}
 ```
 
 ### 声明具有子类型的 List
@@ -43,9 +51,23 @@ my_list: List[str]
 
 因此，在我们的示例中，我们可以将 `tags` 明确地指定为一个「字符串列表」：
 
-```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial002.py!}
+    ```
 
 ## Set 类型
 
@@ -55,9 +77,23 @@ Python 具有一种特殊的数据类型来保存一组唯一的元素，即 `se
 
 然后我们可以导入 `Set` 并将 `tag` 声明为一个由 `str` 组成的 `set`：
 
-```Python hl_lines="1 14"
-{!../../../docs_src/body_nested_models/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  14"
+    {!> ../../../docs_src/body_nested_models/tutorial003.py!}
+    ```
 
 这样，即使你收到带有重复数据的请求，这些数据也会被转换为一组唯一项。
 
@@ -79,17 +115,45 @@ Pydantic 模型的每个属性都具有类型。
 
 例如，我们可以定义一个 `Image` 模型：
 
-```Python hl_lines="9 10 11"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7-9"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9-11"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9-11"
+    {!> ../../../docs_src/body_nested_models/tutorial004.py!}
+    ```
 
 ### 将子模型用作类型
 
 然后我们可以将其用作一个属性的类型：
 
-```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial004.py!}
+    ```
 
 这意味着 **FastAPI** 将期望类似于以下内容的请求体：
 
@@ -122,9 +186,23 @@ Pydantic 模型的每个属性都具有类型。
 
 例如，在 `Image` 模型中我们有一个 `url` 字段，我们可以把它声明为 Pydantic 的 `HttpUrl`，而不是 `str`：
 
-```Python hl_lines="4 10"
-{!../../../docs_src/body_nested_models/tutorial005.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="2  8"
+    {!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="4  10"
+    {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="4  10"
+    {!> ../../../docs_src/body_nested_models/tutorial005.py!}
+    ```
 
 该字符串将被检查是否为有效的 URL，并在 JSON Schema / OpenAPI 文档中进行记录。
 
@@ -132,9 +210,23 @@ Pydantic 模型的每个属性都具有类型。
 
 你还可以将 Pydantic 模型用作 `list`、`set` 等的子类型：
 
-```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial006.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial006.py!}
+    ```
 
 这将期望（转换，校验，记录文档等）下面这样的 JSON 请求体：
 
@@ -169,9 +261,23 @@ Pydantic 模型的每个属性都具有类型。
 
 你可以定义任意深度的嵌套模型：
 
-```Python hl_lines="9 14 20 23 27"
-{!../../../docs_src/body_nested_models/tutorial007.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7  12  18  21  25"
+    {!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9  14  20  23  27"
+    {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9  14  20  23  27"
+    {!> ../../../docs_src/body_nested_models/tutorial007.py!}
+    ```
 
 !!! info
     请注意 `Offer` 拥有一组 `Item` 而反过来 `Item` 又是一个可选的 `Image` 列表是如何发生的。
@@ -186,9 +292,17 @@ images: List[Image]
 
 例如：
 
-```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial008.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="13"
+    {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/body_nested_models/tutorial008.py!}
+    ```
 
 ## 无处不在的编辑器支持
 
@@ -218,9 +332,17 @@ images: List[Image]
 
 在下面的例子中，你将接受任意键为 `int` 类型并且值为 `float` 类型的 `dict`：
 
-```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial009.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/body_nested_models/tutorial009.py!}
+    ```
 
 !!! tip
     请记住 JSON 仅支持将 `str` 作为键。
diff --git a/docs/zh/docs/tutorial/body.md b/docs/zh/docs/tutorial/body.md
index f80ab5bf5..5cf53c0c2 100644
--- a/docs/zh/docs/tutorial/body.md
+++ b/docs/zh/docs/tutorial/body.md
@@ -17,9 +17,17 @@
 
 首先，你需要从 `pydantic` 中导入 `BaseModel`：
 
-```Python hl_lines="2"
-{!../../../docs_src/body/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
 
 ## 创建数据模型
 
@@ -27,9 +35,17 @@
 
 使用标准的 Python 类型来声明所有属性：
 
-```Python hl_lines="5-9"
-{!../../../docs_src/body/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="5-9"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="7-11"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
 
 和声明查询参数时一样，当一个模型属性具有默认值时，它不是必需的。否则它是一个必需属性。将默认值设为 `None` 可使其成为可选属性。
 
@@ -57,9 +73,17 @@
 
 使用与声明路径和查询参数的相同方式声明请求体，即可将其添加到「路径操作」中：
 
-```Python hl_lines="16"
-{!../../../docs_src/body/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
 
 ...并且将它的类型声明为你创建的 `Item` 模型。
 
@@ -112,9 +136,17 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
 
 在函数内部，你可以直接访问模型对象的所有属性：
 
-```Python hl_lines="19"
-{!../../../docs_src/body/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/body/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/body/tutorial002.py!}
+    ```
 
 ## 请求体 + 路径参数
 
@@ -122,9 +154,17 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
 
 **FastAPI** 将识别出与路径参数匹配的函数参数应**从路径中获取**，而声明为 Pydantic 模型的函数参数应**从请求体中获取**。
 
-```Python hl_lines="15-16"
-{!../../../docs_src/body/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="15-16"
+    {!> ../../../docs_src/body/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/body/tutorial003.py!}
+    ```
 
 ## 请求体 + 路径参数 + 查询参数
 
@@ -132,9 +172,17 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
 
 **FastAPI** 会识别它们中的每一个，并从正确的位置获取数据。
 
-```Python hl_lines="16"
-{!../../../docs_src/body/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial004.py!}
+    ```
 
 函数参数将依次按如下规则进行识别：
 
diff --git a/docs/zh/docs/tutorial/cookie-params.md b/docs/zh/docs/tutorial/cookie-params.md
index d67daf0f9..f115f9677 100644
--- a/docs/zh/docs/tutorial/cookie-params.md
+++ b/docs/zh/docs/tutorial/cookie-params.md
@@ -6,9 +6,41 @@
 
 首先，导入 `Cookie`:
 
-```Python hl_lines="3"
-{!../../../docs_src/cookie_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
 
 ## 声明 `Cookie` 参数
 
@@ -17,9 +49,41 @@
 第一个值是参数的默认值，同时也可以传递所有验证参数或注释参数，来校验参数：
 
 
-```Python hl_lines="9"
-{!../../../docs_src/cookie_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
 
 !!! note "技术细节"
     `Cookie` 、`Path` 、`Query`是兄弟类，它们都继承自公共的 `Param` 类
diff --git a/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
index f404820df..1866da298 100644
--- a/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/dependencies/tutorial001.py!}
@@ -85,7 +85,7 @@ fluffy = Cat(name="Mr Fluffy")
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11-15"
     {!> ../../../docs_src/dependencies/tutorial002.py!}
diff --git a/docs/zh/docs/tutorial/encoder.md b/docs/zh/docs/tutorial/encoder.md
index 76ed846ce..859ebc2e8 100644
--- a/docs/zh/docs/tutorial/encoder.md
+++ b/docs/zh/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/zh/docs/tutorial/extra-data-types.md b/docs/zh/docs/tutorial/extra-data-types.md
index ac3e07654..a74efa61b 100644
--- a/docs/zh/docs/tutorial/extra-data-types.md
+++ b/docs/zh/docs/tutorial/extra-data-types.md
@@ -55,12 +55,76 @@
 
 下面是一个*路径操作*的示例，其中的参数使用了上面的一些类型。
 
-```Python hl_lines="1  3  12-16"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  3  13-17"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1  2  11-15"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1  2  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
 
 注意，函数内的参数有原生的数据类型，你可以，例如，执行正常的日期操作，如:
 
-```Python hl_lines="18-19"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="19-20"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
diff --git a/docs/zh/docs/tutorial/extra-models.md b/docs/zh/docs/tutorial/extra-models.md
index 1fbe77be8..06427a73d 100644
--- a/docs/zh/docs/tutorial/extra-models.md
+++ b/docs/zh/docs/tutorial/extra-models.md
@@ -17,9 +17,17 @@
 
 下面是应该如何根据它们的密码字段以及使用位置去定义模型的大概思路：
 
-```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
-{!../../../docs_src/extra_models/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7  9  14  20  22  27-28  31-33  38-39"
+    {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
+    {!> ../../../docs_src/extra_models/tutorial001.py!}
+    ```
 
 ### 关于 `**user_in.dict()`
 
@@ -150,9 +158,17 @@ UserInDB(
 
 这样，我们可以仅声明模型之间的差异部分（具有明文的 `password`、具有 `hashed_password` 以及不包括密码）。
 
-```Python hl_lines="9  15-16  19-20  23-24"
-{!../../../docs_src/extra_models/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7  13-14  17-18  21-22"
+    {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9  15-16  19-20  23-24"
+    {!> ../../../docs_src/extra_models/tutorial002.py!}
+    ```
 
 ## `Union` 或者 `anyOf`
 
@@ -166,9 +182,17 @@ UserInDB(
 !!! note
     定义一个 <a href="https://pydantic-docs.helpmanual.io/usage/types/#unions" class="external-link" target="_blank">`Union`</a> 类型时，首先包括最详细的类型，然后是不太详细的类型。在下面的示例中，更详细的 `PlaneItem` 位于 `Union[PlaneItem，CarItem]` 中的 `CarItem` 之前。
 
-```Python hl_lines="1  14-15  18-20  33"
-{!../../../docs_src/extra_models/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  14-15  18-20  33"
+    {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  14-15  18-20  33"
+    {!> ../../../docs_src/extra_models/tutorial003.py!}
+    ```
 
 ## 模型列表
 
@@ -176,9 +200,17 @@ UserInDB(
 
 为此，请使用标准的 Python `typing.List`：
 
-```Python hl_lines="1  20"
-{!../../../docs_src/extra_models/tutorial004.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  20"
+    {!> ../../../docs_src/extra_models/tutorial004.py!}
+    ```
 
 ## 任意 `dict` 构成的响应
 
@@ -188,9 +220,17 @@ UserInDB(
 
 在这种情况下，你可以使用 `typing.Dict`：
 
-```Python hl_lines="1  8"
-{!../../../docs_src/extra_models/tutorial005.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="6"
+    {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="1  8"
+    {!> ../../../docs_src/extra_models/tutorial005.py!}
+    ```
 
 ## 总结
 
diff --git a/docs/zh/docs/tutorial/handling-errors.md b/docs/zh/docs/tutorial/handling-errors.md
index 9b066bc2c..a0d66e557 100644
--- a/docs/zh/docs/tutorial/handling-errors.md
+++ b/docs/zh/docs/tutorial/handling-errors.md
@@ -145,7 +145,7 @@
 
 ```
 
-访问 `/items/foo`，可以看到以下内容替换了默认 JSON 错误信息：
+访问 `/items/foo`，可以看到默认的 JSON 错误信息：
 
 ```JSON
 {
@@ -163,7 +163,7 @@
 
 ```
 
-以下是文本格式的错误信息：
+被替换为了以下文本格式的错误信息：
 
 ```
 1 validation error
diff --git a/docs/zh/docs/tutorial/header-params.md b/docs/zh/docs/tutorial/header-params.md
index c4b1c38ce..2701167b3 100644
--- a/docs/zh/docs/tutorial/header-params.md
+++ b/docs/zh/docs/tutorial/header-params.md
@@ -6,9 +6,41 @@
 
 首先导入 `Header`:
 
-```Python hl_lines="3"
-{!../../../docs_src/header_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
 
 ## 声明 `Header` 参数
 
@@ -16,9 +48,41 @@
 
 第一个值是默认值，你可以传递所有的额外验证或注释参数：
 
-```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
 
 !!! note "技术细节"
     `Header` 是 `Path`, `Query` 和 `Cookie` 的兄弟类型。它也继承自通用的 `Param` 类.
@@ -44,9 +108,41 @@
 
 如果出于某些原因，你需要禁用下划线到连字符的自动转换，设置`Header`的参数 `convert_underscores` 为 `False`:
 
-```Python hl_lines="10"
-{!../../../docs_src/header_params/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11"
+    {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/header_params/tutorial002_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/header_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002.py!}
+    ```
 
 !!! warning
     在设置 `convert_underscores` 为 `False` 之前，请记住，一些HTTP代理和服务器不允许使用带有下划线的headers。
@@ -62,9 +158,50 @@
 
 比如, 为了声明一个 `X-Token` header 可以出现多次，你可以这样写：
 
-```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.9+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003.py!}
+    ```
 
 如果你与*路径操作*通信时发送两个HTTP headers，就像：
 
diff --git a/docs/zh/docs/tutorial/path-params-numeric-validations.md b/docs/zh/docs/tutorial/path-params-numeric-validations.md
index 13512a08e..9b41ad7cf 100644
--- a/docs/zh/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/zh/docs/tutorial/path-params-numeric-validations.md
@@ -6,9 +6,41 @@
 
 首先，从 `fastapi` 导入 `Path`：
 
-```Python hl_lines="1"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  3"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1  3"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="3-4"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+    ```
 
 ## 声明元数据
 
@@ -16,9 +48,41 @@
 
 例如，要声明路径参数 `item_id`的 `title` 元数据值，你可以输入：
 
-```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="11"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+    ```
 
 !!! note
     路径参数总是必需的，因为它必须是路径的一部分。
@@ -43,9 +107,14 @@
 
 因此，你可以将函数声明为：
 
-```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial002.py!}
-```
+=== "Python 3.8 non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+    ```
 
 ## 按需对参数排序的技巧
 
diff --git a/docs/zh/docs/tutorial/query-params-str-validations.md b/docs/zh/docs/tutorial/query-params-str-validations.md
index 070074839..39253eb0d 100644
--- a/docs/zh/docs/tutorial/query-params-str-validations.md
+++ b/docs/zh/docs/tutorial/query-params-str-validations.md
@@ -4,9 +4,17 @@
 
 让我们以下面的应用程序为例：
 
-```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+    ```
 
 查询参数 `q` 的类型为 `str`，默认值为 `None`，因此它是可选的。
 
diff --git a/docs/zh/docs/tutorial/request-files.md b/docs/zh/docs/tutorial/request-files.md
index 03474907e..2c48f33ca 100644
--- a/docs/zh/docs/tutorial/request-files.md
+++ b/docs/zh/docs/tutorial/request-files.md
@@ -130,7 +130,7 @@ contents = myfile.file.read()
     {!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  17"
     {!> ../../../docs_src/request_files/tutorial001_02.py!}
@@ -158,7 +158,7 @@ FastAPI 支持同时上传多个文件。
     {!> ../../../docs_src/request_files/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10  15"
     {!> ../../../docs_src/request_files/tutorial002.py!}
@@ -183,7 +183,7 @@ FastAPI 支持同时上传多个文件。
     {!> ../../../docs_src/request_files/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/request_files/tutorial003.py!}
diff --git a/docs/zh/docs/tutorial/response-model.md b/docs/zh/docs/tutorial/response-model.md
index ea3d0666d..e731b6989 100644
--- a/docs/zh/docs/tutorial/response-model.md
+++ b/docs/zh/docs/tutorial/response-model.md
@@ -8,9 +8,23 @@
 * `@app.delete()`
 * 等等。
 
-```Python hl_lines="17"
-{!../../../docs_src/response_model/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="17  22  24-27"
+    {!> ../../../docs_src/response_model/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="17  22  24-27"
+    {!> ../../../docs_src/response_model/tutorial001_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="17  22  24-27"
+    {!> ../../../docs_src/response_model/tutorial001.py!}
+    ```
 
 !!! note
     注意，`response_model`是「装饰器」方法（`get`，`post` 等）的一个参数。不像之前的所有参数和请求体，它不属于*路径操作函数*。
@@ -58,21 +72,45 @@ FastAPI 将使用此 `response_model` 来：
 
 相反，我们可以创建一个有明文密码的输入模型和一个没有明文密码的输出模型：
 
-```Python hl_lines="9  11  16"
-{!../../../docs_src/response_model/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9  11  16"
+    {!> ../../../docs_src/response_model/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9  11  16"
+    {!> ../../../docs_src/response_model/tutorial003.py!}
+    ```
 
 这样，即便我们的*路径操作函数*将会返回包含密码的相同输入用户：
 
-```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="24"
+    {!> ../../../docs_src/response_model/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="24"
+    {!> ../../../docs_src/response_model/tutorial003.py!}
+    ```
 
 ...我们已经将 `response_model` 声明为了不包含密码的 `UserOut` 模型：
 
-```Python hl_lines="22"
-{!../../../docs_src/response_model/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/response_model/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/response_model/tutorial003.py!}
+    ```
 
 因此，**FastAPI** 将会负责过滤掉未在输出模型中声明的所有数据（使用 Pydantic）。
 
diff --git a/docs/zh/docs/tutorial/schema-extra-example.md b/docs/zh/docs/tutorial/schema-extra-example.md
index 8f5fbfe70..ebc04da8b 100644
--- a/docs/zh/docs/tutorial/schema-extra-example.md
+++ b/docs/zh/docs/tutorial/schema-extra-example.md
@@ -10,9 +10,17 @@
 
 您可以使用 `Config` 和 `schema_extra` 为Pydantic模型声明一个示例，如<a href="https://pydantic-docs.helpmanual.io/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic 文档：定制 Schema </a>中所述:
 
-```Python hl_lines="15-23"
-{!../../../docs_src/schema_extra_example/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="13-21"
+    {!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="15-23"
+    {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+    ```
 
 这些额外的信息将按原样添加到输出的JSON模式中。
 
@@ -20,9 +28,17 @@
 
 在 `Field`, `Path`, `Query`, `Body` 和其他你之后将会看到的工厂函数，你可以为JSON 模式声明额外信息，你也可以通过给工厂函数传递其他的任意参数来给JSON 模式声明额外信息，比如增加 `example`:
 
-```Python hl_lines="4  10-13"
-{!../../../docs_src/schema_extra_example/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="2  8-11"
+    {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="4  10-13"
+    {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+    ```
 
 !!! warning
     请记住，传递的那些额外参数不会添加任何验证，只会添加注释，用于文档的目的。
@@ -33,9 +49,41 @@
 
 比如，你可以将请求体的一个 `example` 传递给 `Body`:
 
-```Python hl_lines="20-25"
-{!../../../docs_src/schema_extra_example/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="22-27"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="22-27"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="23-28"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="18-23"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="20-25"
+    {!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+    ```
 
 ## 文档 UI 中的例子
 
diff --git a/docs/zh/docs/tutorial/security/first-steps.md b/docs/zh/docs/tutorial/security/first-steps.md
index 86c3320ce..dda956417 100644
--- a/docs/zh/docs/tutorial/security/first-steps.md
+++ b/docs/zh/docs/tutorial/security/first-steps.md
@@ -20,9 +20,26 @@
 
 把下面的示例代码复制到 `main.py`：
 
-```Python
-{!../../../docs_src/security/tutorial001.py!}
-```
+=== "Python 3.9+"
+
+    ```Python
+    {!> ../../../docs_src/security/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python
+    {!> ../../../docs_src/security/tutorial001_an.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python
+    {!> ../../../docs_src/security/tutorial001.py!}
+    ```
 
 ## 运行
 
diff --git a/docs/zh/docs/tutorial/security/simple-oauth2.md b/docs/zh/docs/tutorial/security/simple-oauth2.md
index 276f3d63b..c7f46177f 100644
--- a/docs/zh/docs/tutorial/security/simple-oauth2.md
+++ b/docs/zh/docs/tutorial/security/simple-oauth2.md
@@ -1,94 +1,98 @@
-# 使用密码和 Bearer 的简单 OAuth2
+# OAuth2 实现简单的 Password 和 Bearer 验证
 
-现在让我们接着上一章继续开发，并添加缺少的部分以实现一个完整的安全性流程。
+本章添加上一章示例中欠缺的部分，实现完整的安全流。
 
 ## 获取 `username` 和 `password`
 
-我们将使用 **FastAPI** 的安全性实用工具来获取 `username` 和 `password`。
+首先，使用 **FastAPI** 安全工具获取 `username` 和 `password`。
 
-OAuth2 规定在使用（我们打算用的）「password 流程」时，客户端/用户必须将 `username` 和 `password` 字段作为表单数据发送。
+OAuth2 规范要求使用**密码流**时，客户端或用户必须以表单数据形式发送 `username` 和 `password` 字段。
 
-而且规范明确了字段必须这样命名。因此 `user-name` 或 `email` 是行不通的。
+并且，这两个字段必须命名为 `username` 和 `password` ，不能使用 `user-name` 或 `email` 等其它名称。
 
-不过不用担心，你可以在前端按照你的想法将它展示给最终用户。
+不过也不用担心，前端仍可以显示终端用户所需的名称。
 
-而且你的数据库模型也可以使用你想用的任何其他名称。
+数据库模型也可以使用所需的名称。
 
-但是对于登录*路径操作*，我们需要使用这些名称来与规范兼容（以具备例如使用集成的 API 文档系统的能力）。
+但对于登录*路径操作*，则要使用兼容规范的 `username` 和 `password`，（例如，实现与 API 文档集成）。
 
-规范还写明了 `username` 和 `password` 必须作为表单数据发送（因此，此处不能使用 JSON）。
+该规范要求必须以表单数据形式发送 `username` 和 `password`，因此，不能使用 JSON 对象。
 
-### `scope`
+### `Scope`（作用域）
 
-规范还提到客户端可以发送另一个表单字段「`scope`」。
+OAuth2 还支持客户端发送**`scope`**表单字段。
 
-这个表单字段的名称为 `scope`（单数形式），但实际上它是一个由空格分隔的「作用域」组成的长字符串。
+虽然表单字段的名称是 `scope`（单数），但实际上，它是以空格分隔的，由多个**scope**组成的长字符串。
 
-每个「作用域」只是一个字符串（中间没有空格）。
+**作用域**只是不带空格的字符串。
 
-它们通常用于声明特定的安全权限，例如：
+常用于声明指定安全权限，例如：
 
-* `users:read` 或者 `users:write` 是常见的例子。
-* Facebook / Instagram 使用 `instagram_basic`。
-* Google 使用了 `https://www.googleapis.com/auth/drive` 。
+* 常见用例为，`users:read` 或 `users:write`
+* 脸书和 Instagram 使用 `instagram_basic`
+* 谷歌使用 `https://www.googleapis.com/auth/drive`
 
-!!! info
-    在 OAuth2 中「作用域」只是一个声明所需特定权限的字符串。
+!!! info "说明"
 
-    它有没有 `:` 这样的其他字符或者是不是 URL 都没有关系。
+    OAuth2 中，**作用域**只是声明指定权限的字符串。
 
-    这些细节是具体的实现。
+    是否使用冒号 `:` 等符号，或是不是 URL 并不重要。
 
-    对 OAuth2 来说它们就只是字符串而已。
+    这些细节只是特定的实现方式。
+
+    对 OAuth2 来说，都只是字符串而已。
 
 ## 获取 `username` 和 `password` 的代码
 
-现在，让我们使用 **FastAPI** 提供的实用工具来处理此问题。
+接下来，使用 **FastAPI** 工具获取用户名与密码。
 
 ### `OAuth2PasswordRequestForm`
 
-首先，导入 `OAuth2PasswordRequestForm`，然后在 `token` 的*路径操作*中通过 `Depends` 将其作为依赖项使用。
+首先，导入 `OAuth2PasswordRequestForm`，然后，在 `/token` *路径操作* 中，用 `Depends` 把该类作为依赖项。
 
 ```Python hl_lines="4  76"
 {!../../../docs_src/security/tutorial003.py!}
 ```
 
-`OAuth2PasswordRequestForm` 是一个类依赖项，声明了如下的请求表单：
+`OAuth2PasswordRequestForm` 是用以下几项内容声明表单请求体的类依赖项：
 
-* `username`。
-* `password`。
-* 一个可选的 `scope` 字段，是一个由空格分隔的字符串组成的大字符串。
-* 一个可选的 `grant_type`.
+* `username`
+* `password`
+* 可选的 `scope` 字段，由多个空格分隔的字符串组成的长字符串
+* 可选的 `grant_type`
 
-!!! tip
-    OAuth2 规范实际上*要求* `grant_type` 字段使用一个固定的值 `password`，但是 `OAuth2PasswordRequestForm` 没有作强制约束。
+!!! tip "提示"
 
-    如果你需要强制要求这一点，请使用 `OAuth2PasswordRequestFormStrict` 而不是 `OAuth2PasswordRequestForm`。
+    实际上，OAuth2 规范*要求* `grant_type` 字段使用固定值 `password`，但 `OAuth2PasswordRequestForm` 没有作强制约束。
 
-* 一个可选的 `client_id`（我们的示例不需要它）。
-* 一个可选的 `client_secret`（我们的示例不需要它）。
+    如需强制使用固定值 `password`，则不要用 `OAuth2PasswordRequestForm`，而是用 `OAuth2PasswordRequestFormStrict`。
 
-!!! info
-    `OAuth2PasswordRequestForm` 并不像 `OAuth2PasswordBearer` 一样是 FastAPI 的一个特殊的类。
+* 可选的 `client_id`（本例未使用）
+* 可选的 `client_secret`（本例未使用）
 
-    `OAuth2PasswordBearer` 使得 **FastAPI** 明白它是一个安全方案。所以它得以通过这种方式添加到 OpenAPI 中。
+!!! info "说明"
 
-    但 `OAuth2PasswordRequestForm` 只是一个你可以自己编写的类依赖项，或者你也可以直接声明 `Form` 参数。
+    `OAuth2PasswordRequestForm` 与 `OAuth2PasswordBearer` 一样，都不是 FastAPI 的特殊类。
 
-    但是由于这是一种常见的使用场景，因此 FastAPI 出于简便直接提供了它。
+    **FastAPI** 把 `OAuth2PasswordBearer` 识别为安全方案。因此，可以通过这种方式把它添加至 OpenAPI。
+
+    但 `OAuth2PasswordRequestForm` 只是可以自行编写的类依赖项，也可以直接声明 `Form` 参数。
+
+    但由于这种用例很常见，FastAPI 为了简便，就直接提供了对它的支持。
 
 ### 使用表单数据
 
-!!! tip
-    类依赖项 `OAuth2PasswordRequestForm` 的实例不会有用空格分隔的长字符串属性 `scope`，而是具有一个 `scopes` 属性，该属性将包含实际被发送的每个作用域字符串组成的列表。
+!!! tip "提示"
 
-    在此示例中我们没有使用 `scopes`，但如果你需要的话可以使用该功能。
+    `OAuth2PasswordRequestForm` 类依赖项的实例没有以空格分隔的长字符串属性 `scope`，但它支持 `scopes` 属性，由已发送的 scope 字符串列表组成。
 
-现在，使用表单字段中的 `username` 从（伪）数据库中获取用户数据。
+    本例没有使用 `scopes`，但开发者也可以根据需要使用该属性。
 
-如果没有这个用户，我们将返回一个错误消息，提示「用户名或密码错误」。
+现在，即可使用表单字段 `username`，从（伪）数据库中获取用户数据。
 
-对于这个错误，我们使用 `HTTPException` 异常：
+如果不存在指定用户，则返回错误消息，提示**用户名或密码错误**。
+
+本例使用 `HTTPException` 异常显示此错误：
 
 ```Python hl_lines="3  77-79"
 {!../../../docs_src/security/tutorial003.py!}
@@ -96,27 +100,27 @@ OAuth2 规定在使用（我们打算用的）「password 流程」时，客户
 
 ### 校验密码
 
-目前我们已经从数据库中获取了用户数据，但尚未校验密码。
+至此，我们已经从数据库中获取了用户数据，但尚未校验密码。
 
-让我们首先将这些数据放入 Pydantic `UserInDB` 模型中。
+接下来，首先将数据放入 Pydantic 的 `UserInDB` 模型。
 
-永远不要保存明文密码，因此，我们将使用（伪）哈希密码系统。
+注意：永远不要保存明文密码，本例暂时先使用（伪）哈希密码系统。
 
-如果密码不匹配，我们将返回同一个错误。
+如果密码不匹配，则返回与上面相同的错误。
 
-#### 哈希密码
+#### 密码哈希
 
-「哈希」的意思是：将某些内容（在本例中为密码）转换为看起来像乱码的字节序列（只是一个字符串）。
+**哈希**是指，将指定内容（本例中为密码）转换为形似乱码的字节序列（其实就是字符串）。
 
-每次你传入完全相同的内容（完全相同的密码）时，你都会得到完全相同的乱码。
+每次传入完全相同的内容（比如，完全相同的密码）时，得到的都是完全相同的乱码。
 
-但是你不能从乱码转换回密码。
+但这个乱码无法转换回传入的密码。
 
-##### 为什么使用哈希密码
+##### 为什么使用密码哈希
 
-如果你的数据库被盗，小偷将无法获得用户的明文密码，只有哈希值。
+原因很简单，假如数据库被盗，窃贼无法获取用户的明文密码，得到的只是哈希值。
 
-因此，小偷将无法尝试在另一个系统中使用这些相同的密码（由于许多用户在任何地方都使用相同的密码，因此这很危险）。
+这样一来，窃贼就无法在其它应用中使用窃取的密码，要知道，很多用户在所有系统中都使用相同的密码，风险超大。
 
 ```Python hl_lines="80-83"
 {!../../../docs_src/security/tutorial003.py!}
@@ -124,9 +128,9 @@ OAuth2 规定在使用（我们打算用的）「password 流程」时，客户
 
 #### 关于 `**user_dict`
 
-`UserInDB(**user_dict)` 表示：
+`UserInDB(**user_dict)` 是指：
 
-*直接将 `user_dict` 的键和值作为关键字参数传递，等同于：*
+*直接把 `user_dict` 的键与值当作关键字参数传递，等效于：*
 
 ```Python
 UserInDB(
@@ -138,75 +142,79 @@ UserInDB(
 )
 ```
 
-!!! info
-    有关 `user_dict` 的更完整说明，请参阅[**额外的模型**文档](../extra-models.md#about-user_indict){.internal-link target=_blank}。
+!!! info "说明"
 
-## 返回令牌
+    `user_dict` 的说明，详见[**更多模型**一章](../extra-models.md#about-user_indict){.internal-link target=_blank}。
 
-`token` 端点的响应必须是一个 JSON 对象。
+## 返回 Token
 
-它应该有一个 `token_type`。在我们的例子中，由于我们使用的是「Bearer」令牌，因此令牌类型应为「`bearer`」。
+`token` 端点的响应必须是 JSON 对象。
 
-并且还应该有一个 `access_token` 字段，它是一个包含我们的访问令牌的字符串。
+响应返回的内容应该包含 `token_type`。本例中用的是**Bearer**Token，因此， Token 类型应为**`bearer`**。
 
-对于这个简单的示例，我们将极其不安全地返回相同的 `username` 作为令牌。
+返回内容还应包含 `access_token` 字段，它是包含权限 Token 的字符串。
 
-!!! tip
-    在下一章中，你将看到一个真实的安全实现，使用了哈希密码和 <abbr title="JSON Web Tokens">JWT</abbr> 令牌。
+本例只是简单的演示，返回的 Token 就是 `username`，但这种方式极不安全。
 
-    但现在，让我们仅关注我们需要的特定细节。
+!!! tip "提示"
+
+    下一章介绍使用哈希密码和 <abbr title="JSON Web Tokens">JWT</abbr> Token 的真正安全机制。
+
+    但现在，仅关注所需的特定细节。
 
 ```Python hl_lines="85"
 {!../../../docs_src/security/tutorial003.py!}
 ```
 
-!!! tip
-    根据规范，你应该像本示例一样，返回一个带有 `access_token` 和 `token_type` 的 JSON。
+!!! tip "提示"
 
-    这是你必须在代码中自行完成的工作，并且要确保使用了这些 JSON 字段。
+    按规范的要求，应像本示例一样，返回带有 `access_token` 和 `token_type` 的 JSON 对象。
 
-    这几乎是唯一的你需要自己记住并正确地执行以符合规范的事情。
+    这是开发者必须在代码中自行完成的工作，并且要确保使用这些 JSON 的键。
 
-    其余的，**FastAPI** 都会为你处理。
+    这几乎是唯一需要开发者牢记在心，并按规范要求正确执行的事。
+
+    **FastAPI** 则负责处理其它的工作。
 
 ## 更新依赖项
 
-现在我们将更新我们的依赖项。
+接下来，更新依赖项。
 
-我们想要仅当此用户处于启用状态时才能获取 `current_user`。
+使之仅在当前用户为激活状态时，才能获取 `current_user`。
 
-因此，我们创建了一个额外的依赖项 `get_current_active_user`，而该依赖项又以 `get_current_user` 作为依赖项。
+为此，要再创建一个依赖项 `get_current_active_user`，此依赖项以 `get_current_user` 依赖项为基础。
 
-如果用户不存在或处于未启用状态，则这两个依赖项都将仅返回 HTTP 错误。
+如果用户不存在，或状态为未激活，这两个依赖项都会返回 HTTP 错误。
 
-因此，在我们的端点中，只有当用户存在，身份认证通过且处于启用状态时，我们才能获得该用户：
+因此，在端点中，只有当用户存在、通过身份验证、且状态为激活时，才能获得该用户：
 
 ```Python hl_lines="58-67  69-72  90"
 {!../../../docs_src/security/tutorial003.py!}
 ```
 
-!!! info
-    我们在此处返回的值为 `Bearer` 的额外响应头 `WWW-Authenticate` 也是规范的一部分。
+!!! info "说明"
 
-    任何的 401「未认证」HTTP（错误）状态码都应该返回 `WWW-Authenticate` 响应头。
+    此处返回值为 `Bearer` 的响应头 `WWW-Authenticate` 也是规范的一部分。
 
-    对于 bearer 令牌（我们的例子），该响应头的值应为 `Bearer`。
+    任何 401**UNAUTHORIZED**HTTP（错误）状态码都应返回 `WWW-Authenticate` 响应头。
 
-    实际上你可以忽略这个额外的响应头，不会有什么问题。
+    本例中，因为使用的是 Bearer Token，该响应头的值应为 `Bearer`。
 
-    但此处提供了它以符合规范。
+    实际上，忽略这个附加响应头，也不会有什么问题。
 
-    而且，（现在或将来）可能会有工具期望得到并使用它，然后对你或你的用户有用处。
+    之所以在此提供这个附加响应头，是为了符合规范的要求。
 
-    这就是遵循标准的好处...
+    说不定什么时候，就有工具用得上它，而且，开发者或用户也可能用得上。
+
+    这就是遵循标准的好处……
 
 ## 实际效果
 
-打开交互式文档：<a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>。
+打开 API 文档：<a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>。
 
-### 身份认证
+### 身份验证
 
-点击「Authorize」按钮。
+点击**Authorize**按钮。
 
 使用以下凭证：
 
@@ -216,15 +224,15 @@ UserInDB(
 
 <img src="https://fastapi.tiangolo.com/img/tutorial/security/image04.png">
 
-在系统中进行身份认证后，你将看到：
+通过身份验证后，显示下图所示的内容：
 
 <img src="https://fastapi.tiangolo.com/img/tutorial/security/image05.png">
 
-### 获取本人的用户数据
+### 获取当前用户数据
 
-现在执行 `/users/me` 路径的 `GET` 操作。
+使用 `/users/me` 路径的 `GET` 操作。
 
-你将获得你的用户数据，如：
+可以提取如下当前用户数据：
 
 ```JSON
 {
@@ -238,7 +246,7 @@ UserInDB(
 
 <img src="https://fastapi.tiangolo.com/img/tutorial/security/image06.png">
 
-如果你点击锁定图标并注销，然后再次尝试同一操作，则会得到 HTTP 401 错误：
+点击小锁图标，注销后，再执行同样的操作，则会得到 HTTP 401 错误：
 
 ```JSON
 {
@@ -246,17 +254,17 @@ UserInDB(
 }
 ```
 
-### 未启用的用户
+### 未激活用户
 
-现在尝试使用未启用的用户，并通过以下方式进行身份认证：
+测试未激活用户，输入以下信息，进行身份验证：
 
 用户名：`alice`
 
 密码：`secret2`
 
-然后尝试执行 `/users/me` 路径的 `GET` 操作。
+然后，执行 `/users/me` 路径的 `GET` 操作。
 
-你将得到一个「未启用的用户」错误，如：
+显示下列**未激活用户**错误信息：
 
 ```JSON
 {
@@ -264,12 +272,12 @@ UserInDB(
 }
 ```
 
-## 总结
+## 小结
 
-现在你掌握了为你的 API 实现一个基于 `username` 和 `password` 的完整安全系统的工具。
+使用本章的工具实现基于 `username` 和 `password` 的完整 API 安全系统。
 
-使用这些工具，你可以使安全系统与任何数据库以及任何用户或数据模型兼容。
+这些工具让安全系统兼容任何数据库、用户及数据模型。
 
-唯一缺少的细节是它实际上还并不「安全」。
+唯一欠缺的是，它仍然不是真的**安全**。
 
-在下一章中，你将看到如何使用一个安全的哈希密码库和 <abbr title="JSON Web Tokens">JWT</abbr> 令牌。
+下一章，介绍使用密码哈希支持库与 <abbr title="JSON Web Tokens">JWT</abbr> 令牌实现真正的安全机制。
diff --git a/docs/zh/docs/tutorial/sql-databases.md b/docs/zh/docs/tutorial/sql-databases.md
index 482588f94..8b09dc677 100644
--- a/docs/zh/docs/tutorial/sql-databases.md
+++ b/docs/zh/docs/tutorial/sql-databases.md
@@ -258,7 +258,7 @@ connect_args={"check_same_thread": False}
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  6-8  11-12  23-24  27-28"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -302,7 +302,7 @@ name: str
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-17  31-34"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -331,7 +331,7 @@ name: str
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15  19-20  31  36-37"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -471,7 +471,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -505,7 +505,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-20"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -530,7 +530,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24  32  38  47  53"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -551,7 +551,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28  31-34  37-42  45-49  52-55"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -650,7 +650,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -670,7 +670,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -729,7 +729,7 @@ $ uvicorn sql_app.main:app --reload
     {!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14-22"
     {!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
diff --git a/docs/zh/docs/tutorial/testing.md b/docs/zh/docs/tutorial/testing.md
index 41f01f8d8..77fff7596 100644
--- a/docs/zh/docs/tutorial/testing.md
+++ b/docs/zh/docs/tutorial/testing.md
@@ -122,7 +122,7 @@
     {!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/app_testing/app_b_an/main.py!}
@@ -137,7 +137,7 @@
     {!> ../../../docs_src/app_testing/app_b_py310/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs_src/extending_openapi/tutorial003.py b/docs_src/configure_swagger_ui/tutorial001.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial003.py
rename to docs_src/configure_swagger_ui/tutorial001.py
diff --git a/docs_src/extending_openapi/tutorial004.py b/docs_src/configure_swagger_ui/tutorial002.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial004.py
rename to docs_src/configure_swagger_ui/tutorial002.py
diff --git a/docs_src/extending_openapi/tutorial005.py b/docs_src/configure_swagger_ui/tutorial003.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial005.py
rename to docs_src/configure_swagger_ui/tutorial003.py
diff --git a/docs_src/custom_docs_ui/tutorial001.py b/docs_src/custom_docs_ui/tutorial001.py
new file mode 100644
index 000000000..4384433e3
--- /dev/null
+++ b/docs_src/custom_docs_ui/tutorial001.py
@@ -0,0 +1,38 @@
+from fastapi import FastAPI
+from fastapi.openapi.docs import (
+    get_redoc_html,
+    get_swagger_ui_html,
+    get_swagger_ui_oauth2_redirect_html,
+)
+
+app = FastAPI(docs_url=None, redoc_url=None)
+
+
+@app.get("/docs", include_in_schema=False)
+async def custom_swagger_ui_html():
+    return get_swagger_ui_html(
+        openapi_url=app.openapi_url,
+        title=app.title + " - Swagger UI",
+        oauth2_redirect_url=app.swagger_ui_oauth2_redirect_url,
+        swagger_js_url="https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui-bundle.js",
+        swagger_css_url="https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui.css",
+    )
+
+
+@app.get(app.swagger_ui_oauth2_redirect_url, include_in_schema=False)
+async def swagger_ui_redirect():
+    return get_swagger_ui_oauth2_redirect_html()
+
+
+@app.get("/redoc", include_in_schema=False)
+async def redoc_html():
+    return get_redoc_html(
+        openapi_url=app.openapi_url,
+        title=app.title + " - ReDoc",
+        redoc_js_url="https://unpkg.com/redoc@next/bundles/redoc.standalone.js",
+    )
+
+
+@app.get("/users/{username}")
+async def read_user(username: str):
+    return {"message": f"Hello {username}"}
diff --git a/docs_src/extending_openapi/tutorial002.py b/docs_src/custom_docs_ui/tutorial002.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial002.py
rename to docs_src/custom_docs_ui/tutorial002.py
diff --git a/docs_src/header_params/tutorial002_an.py b/docs_src/header_params/tutorial002_an.py
index 65d972d46..82fe49ba2 100644
--- a/docs_src/header_params/tutorial002_an.py
+++ b/docs_src/header_params/tutorial002_an.py
@@ -10,6 +10,6 @@ app = FastAPI()
 async def read_items(
     strange_header: Annotated[
         Union[str, None], Header(convert_underscores=False)
-    ] = None
+    ] = None,
 ):
     return {"strange_header": strange_header}
diff --git a/docs_src/header_params/tutorial002_an_py39.py b/docs_src/header_params/tutorial002_an_py39.py
index 7f6a99f9c..008e4b6e1 100644
--- a/docs_src/header_params/tutorial002_an_py39.py
+++ b/docs_src/header_params/tutorial002_an_py39.py
@@ -9,6 +9,6 @@ app = FastAPI()
 async def read_items(
     strange_header: Annotated[
         Union[str, None], Header(convert_underscores=False)
-    ] = None
+    ] = None,
 ):
     return {"strange_header": strange_header}
diff --git a/docs_src/openapi_webhooks/tutorial001.py b/docs_src/openapi_webhooks/tutorial001.py
index 5016f5b00..55822bb48 100644
--- a/docs_src/openapi_webhooks/tutorial001.py
+++ b/docs_src/openapi_webhooks/tutorial001.py
@@ -8,7 +8,7 @@ app = FastAPI()
 
 class Subscription(BaseModel):
     username: str
-    montly_fee: float
+    monthly_fee: float
     start_date: datetime
 
 
diff --git a/docs_src/python_types/tutorial011.py b/docs_src/python_types/tutorial011.py
index c8634cbff..297a84db6 100644
--- a/docs_src/python_types/tutorial011.py
+++ b/docs_src/python_types/tutorial011.py
@@ -6,7 +6,7 @@ from pydantic import BaseModel
 
 class User(BaseModel):
     id: int
-    name = "John Doe"
+    name: str = "John Doe"
     signup_ts: Union[datetime, None] = None
     friends: List[int] = []
 
diff --git a/docs_src/python_types/tutorial011_py310.py b/docs_src/python_types/tutorial011_py310.py
index 7f173880f..842760c60 100644
--- a/docs_src/python_types/tutorial011_py310.py
+++ b/docs_src/python_types/tutorial011_py310.py
@@ -5,7 +5,7 @@ from pydantic import BaseModel
 
 class User(BaseModel):
     id: int
-    name = "John Doe"
+    name: str = "John Doe"
     signup_ts: datetime | None = None
     friends: list[int] = []
 
diff --git a/docs_src/python_types/tutorial011_py39.py b/docs_src/python_types/tutorial011_py39.py
index 468496f51..4eb40b405 100644
--- a/docs_src/python_types/tutorial011_py39.py
+++ b/docs_src/python_types/tutorial011_py39.py
@@ -6,7 +6,7 @@ from pydantic import BaseModel
 
 class User(BaseModel):
     id: int
-    name = "John Doe"
+    name: str = "John Doe"
     signup_ts: Union[datetime, None] = None
     friends: list[int] = []
 
diff --git a/docs_src/query_params_str_validations/tutorial004.py b/docs_src/query_params_str_validations/tutorial004.py
index 3639b6c38..64a647a16 100644
--- a/docs_src/query_params_str_validations/tutorial004.py
+++ b/docs_src/query_params_str_validations/tutorial004.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Union[str, None] = Query(
         default=None, min_length=3, max_length=50, pattern="^fixedquery$"
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an.py b/docs_src/query_params_str_validations/tutorial004_an.py
index 24698c7b3..c75d45d63 100644
--- a/docs_src/query_params_str_validations/tutorial004_an.py
+++ b/docs_src/query_params_str_validations/tutorial004_an.py
@@ -10,7 +10,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         Union[str, None], Query(min_length=3, max_length=50, pattern="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an_py310.py b/docs_src/query_params_str_validations/tutorial004_an_py310.py
index b7b629ee8..20cf1988f 100644
--- a/docs_src/query_params_str_validations/tutorial004_an_py310.py
+++ b/docs_src/query_params_str_validations/tutorial004_an_py310.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         str | None, Query(min_length=3, max_length=50, pattern="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py b/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py
index 8fd375b3d..21e0d3eb8 100644
--- a/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py
+++ b/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         str | None, Query(min_length=3, max_length=50, regex="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an_py39.py b/docs_src/query_params_str_validations/tutorial004_an_py39.py
index 8e9a6fc32..de27097b3 100644
--- a/docs_src/query_params_str_validations/tutorial004_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial004_an_py39.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         Union[str, None], Query(min_length=3, max_length=50, pattern="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_py310.py b/docs_src/query_params_str_validations/tutorial004_py310.py
index f80798bcb..7801e7500 100644
--- a/docs_src/query_params_str_validations/tutorial004_py310.py
+++ b/docs_src/query_params_str_validations/tutorial004_py310.py
@@ -5,8 +5,9 @@ app = FastAPI()
 
 @app.get("/items/")
 async def read_items(
-    q: str
-    | None = Query(default=None, min_length=3, max_length=50, pattern="^fixedquery$")
+    q: str | None = Query(
+        default=None, min_length=3, max_length=50, pattern="^fixedquery$"
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008.py b/docs_src/query_params_str_validations/tutorial008.py
index d112a9ab8..e3e0b50aa 100644
--- a/docs_src/query_params_str_validations/tutorial008.py
+++ b/docs_src/query_params_str_validations/tutorial008.py
@@ -12,7 +12,7 @@ async def read_items(
         title="Query string",
         description="Query string for the items to search in the database that have a good match",
         min_length=3,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_an.py b/docs_src/query_params_str_validations/tutorial008_an.py
index 5699f1e88..01606a920 100644
--- a/docs_src/query_params_str_validations/tutorial008_an.py
+++ b/docs_src/query_params_str_validations/tutorial008_an.py
@@ -15,7 +15,7 @@ async def read_items(
             description="Query string for the items to search in the database that have a good match",
             min_length=3,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_an_py310.py b/docs_src/query_params_str_validations/tutorial008_an_py310.py
index 4aaadf8b4..44b3082b6 100644
--- a/docs_src/query_params_str_validations/tutorial008_an_py310.py
+++ b/docs_src/query_params_str_validations/tutorial008_an_py310.py
@@ -14,7 +14,7 @@ async def read_items(
             description="Query string for the items to search in the database that have a good match",
             min_length=3,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_an_py39.py b/docs_src/query_params_str_validations/tutorial008_an_py39.py
index 1c3b36176..f3f2f2c0e 100644
--- a/docs_src/query_params_str_validations/tutorial008_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial008_an_py39.py
@@ -14,7 +14,7 @@ async def read_items(
             description="Query string for the items to search in the database that have a good match",
             min_length=3,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_py310.py b/docs_src/query_params_str_validations/tutorial008_py310.py
index 489f631d5..574385272 100644
--- a/docs_src/query_params_str_validations/tutorial008_py310.py
+++ b/docs_src/query_params_str_validations/tutorial008_py310.py
@@ -5,13 +5,12 @@ app = FastAPI()
 
 @app.get("/items/")
 async def read_items(
-    q: str
-    | None = Query(
+    q: str | None = Query(
         default=None,
         title="Query string",
         description="Query string for the items to search in the database that have a good match",
         min_length=3,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010.py b/docs_src/query_params_str_validations/tutorial010.py
index 3314f8b6d..ff29176fe 100644
--- a/docs_src/query_params_str_validations/tutorial010.py
+++ b/docs_src/query_params_str_validations/tutorial010.py
@@ -16,7 +16,7 @@ async def read_items(
         max_length=50,
         pattern="^fixedquery$",
         deprecated=True,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_an.py b/docs_src/query_params_str_validations/tutorial010_an.py
index c5df00897..ed343230f 100644
--- a/docs_src/query_params_str_validations/tutorial010_an.py
+++ b/docs_src/query_params_str_validations/tutorial010_an.py
@@ -19,7 +19,7 @@ async def read_items(
             pattern="^fixedquery$",
             deprecated=True,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_an_py310.py b/docs_src/query_params_str_validations/tutorial010_an_py310.py
index a8e8c099b..775095bda 100644
--- a/docs_src/query_params_str_validations/tutorial010_an_py310.py
+++ b/docs_src/query_params_str_validations/tutorial010_an_py310.py
@@ -18,7 +18,7 @@ async def read_items(
             pattern="^fixedquery$",
             deprecated=True,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_an_py39.py b/docs_src/query_params_str_validations/tutorial010_an_py39.py
index 955880dd6..b126c116f 100644
--- a/docs_src/query_params_str_validations/tutorial010_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial010_an_py39.py
@@ -18,7 +18,7 @@ async def read_items(
             pattern="^fixedquery$",
             deprecated=True,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_py310.py b/docs_src/query_params_str_validations/tutorial010_py310.py
index 9ea7b3c49..530e6cf5b 100644
--- a/docs_src/query_params_str_validations/tutorial010_py310.py
+++ b/docs_src/query_params_str_validations/tutorial010_py310.py
@@ -5,8 +5,7 @@ app = FastAPI()
 
 @app.get("/items/")
 async def read_items(
-    q: str
-    | None = Query(
+    q: str | None = Query(
         default=None,
         alias="item-query",
         title="Query string",
@@ -15,7 +14,7 @@ async def read_items(
         max_length=50,
         pattern="^fixedquery$",
         deprecated=True,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/schema_extra_example/tutorial005.py b/docs_src/schema_extra_example/tutorial005.py
new file mode 100644
index 000000000..b8217c27e
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005.py
@@ -0,0 +1,51 @@
+from typing import Union
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+    price: float
+    tax: Union[float, None] = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Item = Body(
+        openapi_examples={
+            "normal": {
+                "summary": "A normal example",
+                "description": "A **normal** item works correctly.",
+                "value": {
+                    "name": "Foo",
+                    "description": "A very nice Item",
+                    "price": 35.4,
+                    "tax": 3.2,
+                },
+            },
+            "converted": {
+                "summary": "An example with converted data",
+                "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                "value": {
+                    "name": "Bar",
+                    "price": "35.4",
+                },
+            },
+            "invalid": {
+                "summary": "Invalid data is rejected with an error",
+                "value": {
+                    "name": "Baz",
+                    "price": "thirty five point four",
+                },
+            },
+        },
+    ),
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_an.py b/docs_src/schema_extra_example/tutorial005_an.py
new file mode 100644
index 000000000..4b2d9c662
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_an.py
@@ -0,0 +1,55 @@
+from typing import Union
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+    price: float
+    tax: Union[float, None] = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Annotated[
+        Item,
+        Body(
+            openapi_examples={
+                "normal": {
+                    "summary": "A normal example",
+                    "description": "A **normal** item works correctly.",
+                    "value": {
+                        "name": "Foo",
+                        "description": "A very nice Item",
+                        "price": 35.4,
+                        "tax": 3.2,
+                    },
+                },
+                "converted": {
+                    "summary": "An example with converted data",
+                    "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                    "value": {
+                        "name": "Bar",
+                        "price": "35.4",
+                    },
+                },
+                "invalid": {
+                    "summary": "Invalid data is rejected with an error",
+                    "value": {
+                        "name": "Baz",
+                        "price": "thirty five point four",
+                    },
+                },
+            },
+        ),
+    ],
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_an_py310.py b/docs_src/schema_extra_example/tutorial005_an_py310.py
new file mode 100644
index 000000000..64dc2cf90
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_an_py310.py
@@ -0,0 +1,54 @@
+from typing import Annotated
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+    price: float
+    tax: float | None = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Annotated[
+        Item,
+        Body(
+            openapi_examples={
+                "normal": {
+                    "summary": "A normal example",
+                    "description": "A **normal** item works correctly.",
+                    "value": {
+                        "name": "Foo",
+                        "description": "A very nice Item",
+                        "price": 35.4,
+                        "tax": 3.2,
+                    },
+                },
+                "converted": {
+                    "summary": "An example with converted data",
+                    "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                    "value": {
+                        "name": "Bar",
+                        "price": "35.4",
+                    },
+                },
+                "invalid": {
+                    "summary": "Invalid data is rejected with an error",
+                    "value": {
+                        "name": "Baz",
+                        "price": "thirty five point four",
+                    },
+                },
+            },
+        ),
+    ],
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_an_py39.py b/docs_src/schema_extra_example/tutorial005_an_py39.py
new file mode 100644
index 000000000..edeb1affc
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_an_py39.py
@@ -0,0 +1,54 @@
+from typing import Annotated, Union
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+    price: float
+    tax: Union[float, None] = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Annotated[
+        Item,
+        Body(
+            openapi_examples={
+                "normal": {
+                    "summary": "A normal example",
+                    "description": "A **normal** item works correctly.",
+                    "value": {
+                        "name": "Foo",
+                        "description": "A very nice Item",
+                        "price": 35.4,
+                        "tax": 3.2,
+                    },
+                },
+                "converted": {
+                    "summary": "An example with converted data",
+                    "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                    "value": {
+                        "name": "Bar",
+                        "price": "35.4",
+                    },
+                },
+                "invalid": {
+                    "summary": "Invalid data is rejected with an error",
+                    "value": {
+                        "name": "Baz",
+                        "price": "thirty five point four",
+                    },
+                },
+            },
+        ),
+    ],
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_py310.py b/docs_src/schema_extra_example/tutorial005_py310.py
new file mode 100644
index 000000000..eef973343
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_py310.py
@@ -0,0 +1,49 @@
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+    price: float
+    tax: float | None = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Item = Body(
+        openapi_examples={
+            "normal": {
+                "summary": "A normal example",
+                "description": "A **normal** item works correctly.",
+                "value": {
+                    "name": "Foo",
+                    "description": "A very nice Item",
+                    "price": 35.4,
+                    "tax": 3.2,
+                },
+            },
+            "converted": {
+                "summary": "An example with converted data",
+                "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                "value": {
+                    "name": "Bar",
+                    "price": "35.4",
+                },
+            },
+            "invalid": {
+                "summary": "Invalid data is rejected with an error",
+                "value": {
+                    "name": "Baz",
+                    "price": "thirty five point four",
+                },
+            },
+        },
+    ),
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/separate_openapi_schemas/tutorial001.py b/docs_src/separate_openapi_schemas/tutorial001.py
new file mode 100644
index 000000000..415eef8e2
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial001.py
@@ -0,0 +1,28 @@
+from typing import List, Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+
+
+app = FastAPI()
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> List[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial001_py310.py b/docs_src/separate_openapi_schemas/tutorial001_py310.py
new file mode 100644
index 000000000..289cb54ed
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial001_py310.py
@@ -0,0 +1,26 @@
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+
+
+app = FastAPI()
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial001_py39.py b/docs_src/separate_openapi_schemas/tutorial001_py39.py
new file mode 100644
index 000000000..63cffd1e3
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial001_py39.py
@@ -0,0 +1,28 @@
+from typing import Optional
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Optional[str] = None
+
+
+app = FastAPI()
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial002.py b/docs_src/separate_openapi_schemas/tutorial002.py
new file mode 100644
index 000000000..7df93783b
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial002.py
@@ -0,0 +1,28 @@
+from typing import List, Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+
+
+app = FastAPI(separate_input_output_schemas=False)
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> List[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial002_py310.py b/docs_src/separate_openapi_schemas/tutorial002_py310.py
new file mode 100644
index 000000000..5db210872
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial002_py310.py
@@ -0,0 +1,26 @@
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+
+
+app = FastAPI(separate_input_output_schemas=False)
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial002_py39.py b/docs_src/separate_openapi_schemas/tutorial002_py39.py
new file mode 100644
index 000000000..50d997d92
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial002_py39.py
@@ -0,0 +1,28 @@
+from typing import Optional
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Optional[str] = None
+
+
+app = FastAPI(separate_input_output_schemas=False)
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/settings/app02/main.py b/docs_src/settings/app02/main.py
index 163aa2614..941f82e6b 100644
--- a/docs_src/settings/app02/main.py
+++ b/docs_src/settings/app02/main.py
@@ -7,7 +7,7 @@ from .config import Settings
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return Settings()
 
diff --git a/docs_src/settings/app02_an/main.py b/docs_src/settings/app02_an/main.py
index cb679202d..3a578cc33 100644
--- a/docs_src/settings/app02_an/main.py
+++ b/docs_src/settings/app02_an/main.py
@@ -8,7 +8,7 @@ from .config import Settings
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return Settings()
 
diff --git a/docs_src/settings/app02_an_py39/main.py b/docs_src/settings/app02_an_py39/main.py
index 61be74fcb..6d5db12a8 100644
--- a/docs_src/settings/app02_an_py39/main.py
+++ b/docs_src/settings/app02_an_py39/main.py
@@ -8,7 +8,7 @@ from .config import Settings
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return Settings()
 
diff --git a/docs_src/settings/app03/main.py b/docs_src/settings/app03/main.py
index 69bc8c6e0..ea64a5709 100644
--- a/docs_src/settings/app03/main.py
+++ b/docs_src/settings/app03/main.py
@@ -7,7 +7,7 @@ from . import config
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return config.Settings()
 
diff --git a/docs_src/settings/app03_an/main.py b/docs_src/settings/app03_an/main.py
index c33b98f47..2f64b9cd1 100644
--- a/docs_src/settings/app03_an/main.py
+++ b/docs_src/settings/app03_an/main.py
@@ -8,7 +8,7 @@ from . import config
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return config.Settings()
 
diff --git a/docs_src/settings/app03_an_py39/main.py b/docs_src/settings/app03_an_py39/main.py
index b89c6b6cf..62f347639 100644
--- a/docs_src/settings/app03_an_py39/main.py
+++ b/docs_src/settings/app03_an_py39/main.py
@@ -8,7 +8,7 @@ from . import config
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return config.Settings()
 
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index e9c3abe01..c81f09b27 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.100.0"
+__version__ = "0.104.1"
 
 from starlette import status as status
 
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index 2233fe33c..fc605d0ec 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -56,12 +56,17 @@ if PYDANTIC_V2:
     from pydantic.json_schema import GenerateJsonSchema as GenerateJsonSchema
     from pydantic.json_schema import JsonSchemaValue as JsonSchemaValue
     from pydantic_core import CoreSchema as CoreSchema
-    from pydantic_core import MultiHostUrl as MultiHostUrl
     from pydantic_core import PydanticUndefined, PydanticUndefinedType
     from pydantic_core import Url as Url
-    from pydantic_core.core_schema import (
-        general_plain_validator_function as general_plain_validator_function,
-    )
+
+    try:
+        from pydantic_core.core_schema import (
+            with_info_plain_validator_function as with_info_plain_validator_function,
+        )
+    except ImportError:  # pragma: no cover
+        from pydantic_core.core_schema import (
+            general_plain_validator_function as with_info_plain_validator_function,  # noqa: F401
+        )
 
     Required = PydanticUndefined
     Undefined = PydanticUndefined
@@ -182,15 +187,19 @@ if PYDANTIC_V2:
         field_mapping: Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
         ],
+        separate_input_output_schemas: bool = True,
     ) -> Dict[str, Any]:
+        override_mode: Union[Literal["validation"], None] = (
+            None if separate_input_output_schemas else "validation"
+        )
         # This expects that GenerateJsonSchema was already used to generate the definitions
-        json_schema = field_mapping[(field, field.mode)]
+        json_schema = field_mapping[(field, override_mode or field.mode)]
         if "$ref" not in json_schema:
             # TODO remove when deprecating Pydantic v1
             # Ref: https://github.com/pydantic/pydantic/blob/d61792cc42c80b13b23e3ffa74bc37ec7c77f7d1/pydantic/schema.py#L207
-            json_schema[
-                "title"
-            ] = field.field_info.title or field.alias.title().replace("_", " ")
+            json_schema["title"] = (
+                field.field_info.title or field.alias.title().replace("_", " ")
+            )
         return json_schema
 
     def get_compat_model_name_map(fields: List[ModelField]) -> ModelNameMap:
@@ -201,14 +210,19 @@ if PYDANTIC_V2:
         fields: List[ModelField],
         schema_generator: GenerateJsonSchema,
         model_name_map: ModelNameMap,
+        separate_input_output_schemas: bool = True,
     ) -> Tuple[
         Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
         ],
         Dict[str, Dict[str, Any]],
     ]:
+        override_mode: Union[Literal["validation"], None] = (
+            None if separate_input_output_schemas else "validation"
+        )
         inputs = [
-            (field, field.mode, field._type_adapter.core_schema) for field in fields
+            (field, override_mode or field.mode, field._type_adapter.core_schema)
+            for field in fields
         ]
         field_mapping, definitions = schema_generator.generate_definitions(
             inputs=inputs
@@ -294,9 +308,6 @@ else:
     from pydantic.fields import (  # type: ignore[no-redef, attr-defined]
         UndefinedType as UndefinedType,  # noqa: F401
     )
-    from pydantic.networks import (  # type: ignore[no-redef]
-        MultiHostDsn as MultiHostUrl,  # noqa: F401
-    )
     from pydantic.schema import (
         field_schema,
         get_flat_models_from_fields,
@@ -340,7 +351,7 @@ else:
     class PydanticSchemaGenerationError(Exception):  # type: ignore[no-redef]
         pass
 
-    def general_plain_validator_function(  # type: ignore[misc]
+    def with_info_plain_validator_function(  # type: ignore[misc]
         function: Callable[..., Any],
         *,
         ref: Union[str, None] = None,
@@ -433,6 +444,7 @@ else:
         field_mapping: Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
         ],
+        separate_input_output_schemas: bool = True,
     ) -> Dict[str, Any]:
         # This expects that GenerateJsonSchema was already used to generate the definitions
         return field_schema(  # type: ignore[no-any-return]
@@ -448,6 +460,7 @@ else:
         fields: List[ModelField],
         schema_generator: GenerateJsonSchema,
         model_name_map: ModelNameMap,
+        separate_input_output_schemas: bool = True,
     ) -> Tuple[
         Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
diff --git a/fastapi/applications.py b/fastapi/applications.py
index e32cfa03d..3021d7593 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -43,56 +43,785 @@ from starlette.requests import Request
 from starlette.responses import HTMLResponse, JSONResponse, Response
 from starlette.routing import BaseRoute
 from starlette.types import ASGIApp, Lifespan, Receive, Scope, Send
+from typing_extensions import Annotated, Doc, deprecated  # type: ignore [attr-defined]
 
 AppType = TypeVar("AppType", bound="FastAPI")
 
 
 class FastAPI(Starlette):
+    """
+    `FastAPI` app class, the main entrypoint to use FastAPI.
+
+    Read more in the
+    [FastAPI docs for First Steps](https://fastapi.tiangolo.com/tutorial/first-steps/).
+
+    ## Example
+
+    ```python
+    from fastapi import FastAPI
+
+    app = FastAPI()
+    ```
+    """
+
     def __init__(
         self: AppType,
         *,
-        debug: bool = False,
-        routes: Optional[List[BaseRoute]] = None,
-        title: str = "FastAPI",
-        summary: Optional[str] = None,
-        description: str = "",
-        version: str = "0.1.0",
-        openapi_url: Optional[str] = "/openapi.json",
-        openapi_tags: Optional[List[Dict[str, Any]]] = None,
-        servers: Optional[List[Dict[str, Union[str, Any]]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        redirect_slashes: bool = True,
-        docs_url: Optional[str] = "/docs",
-        redoc_url: Optional[str] = "/redoc",
-        swagger_ui_oauth2_redirect_url: Optional[str] = "/docs/oauth2-redirect",
-        swagger_ui_init_oauth: Optional[Dict[str, Any]] = None,
-        middleware: Optional[Sequence[Middleware]] = None,
-        exception_handlers: Optional[
-            Dict[
-                Union[int, Type[Exception]],
-                Callable[[Request, Any], Coroutine[Any, Any, Response]],
-            ]
+        debug: Annotated[
+            bool,
+            Doc(
+                """
+                Boolean indicating if debug tracebacks should be returned on server
+                errors.
+
+                Read more in the
+                [Starlette docs for Applications](https://www.starlette.io/applications/#instantiating-the-application).
+                """
+            ),
+        ] = False,
+        routes: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                **Note**: you probably shouldn't use this parameter, it is inherited
+                from Starlette and supported for compatibility.
+
+                ---
+
+                A list of routes to serve incoming HTTP and WebSocket requests.
+                """
+            ),
+            deprecated(
+                """
+                You normally wouldn't use this parameter with FastAPI, it is inherited
+                from Starlette and supported for compatibility.
+
+                In FastAPI, you normally would use the *path operation methods*,
+                like `app.get()`, `app.post()`, etc.
+                """
+            ),
         ] = None,
-        on_startup: Optional[Sequence[Callable[[], Any]]] = None,
-        on_shutdown: Optional[Sequence[Callable[[], Any]]] = None,
-        lifespan: Optional[Lifespan[AppType]] = None,
-        terms_of_service: Optional[str] = None,
-        contact: Optional[Dict[str, Union[str, Any]]] = None,
-        license_info: Optional[Dict[str, Union[str, Any]]] = None,
-        openapi_prefix: str = "",
-        root_path: str = "",
-        root_path_in_servers: bool = True,
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        webhooks: Optional[routing.APIRouter] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        swagger_ui_parameters: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
-        **extra: Any,
+        title: Annotated[
+            str,
+            Doc(
+                """
+                The title of the API.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(title="ChimichangApp")
+                ```
+                """
+            ),
+        ] = "FastAPI",
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A short summary of the API.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(summary="Deadpond's favorite app. Nuff said.")
+                ```
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            str,
+            Doc(
+                '''
+                A description of the API. Supports Markdown (using
+                [CommonMark syntax](https://commonmark.org/)).
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(
+                    description="""
+                                ChimichangApp API helps you do awesome stuff. 🚀
+
+                                ## Items
+
+                                You can **read items**.
+
+                                ## Users
+
+                                You will be able to:
+
+                                * **Create users** (_not implemented_).
+                                * **Read users** (_not implemented_).
+
+                                """
+                )
+                ```
+                '''
+            ),
+        ] = "",
+        version: Annotated[
+            str,
+            Doc(
+                """
+                The version of the API.
+
+                **Note** This is the version of your application, not the version of
+                the OpenAPI specification nor the version of FastAPI being used.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(version="0.0.1")
+                ```
+                """
+            ),
+        ] = "0.1.0",
+        openapi_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The URL where the OpenAPI schema will be served from.
+
+                If you set it to `None`, no OpenAPI schema will be served publicly, and
+                the default automatic endpoints `/docs` and `/redoc` will also be
+                disabled.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#openapi-url).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(openapi_url="/api/v1/openapi.json")
+                ```
+                """
+            ),
+        ] = "/openapi.json",
+        openapi_tags: Annotated[
+            Optional[List[Dict[str, Any]]],
+            Doc(
+                """
+                A list of tags used by OpenAPI, these are the same `tags` you can set
+                in the *path operations*, like:
+
+                * `@app.get("/users/", tags=["users"])`
+                * `@app.get("/items/", tags=["items"])`
+
+                The order of the tags can be used to specify the order shown in
+                tools like Swagger UI, used in the automatic path `/docs`.
+
+                It's not required to specify all the tags used.
+
+                The tags that are not declared MAY be organized randomly or based
+                on the tools' logic. Each tag name in the list MUST be unique.
+
+                The value of each item is a `dict` containing:
+
+                * `name`: The name of the tag.
+                * `description`: A short description of the tag.
+                    [CommonMark syntax](https://commonmark.org/) MAY be used for rich
+                    text representation.
+                * `externalDocs`: Additional external documentation for this tag. If
+                    provided, it would contain a `dict` with:
+                    * `description`: A short description of the target documentation.
+                        [CommonMark syntax](https://commonmark.org/) MAY be used for
+                        rich text representation.
+                    * `url`: The URL for the target documentation. Value MUST be in
+                        the form of a URL.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-tags).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                tags_metadata = [
+                    {
+                        "name": "users",
+                        "description": "Operations with users. The **login** logic is also here.",
+                    },
+                    {
+                        "name": "items",
+                        "description": "Manage items. So _fancy_ they have their own docs.",
+                        "externalDocs": {
+                            "description": "Items external docs",
+                            "url": "https://fastapi.tiangolo.com/",
+                        },
+                    },
+                ]
+
+                app = FastAPI(openapi_tags=tags_metadata)
+                ```
+                """
+            ),
+        ] = None,
+        servers: Annotated[
+            Optional[List[Dict[str, Union[str, Any]]]],
+            Doc(
+                """
+                A `list` of `dict`s with connectivity information to a target server.
+
+                You would use it, for example, if your application is served from
+                different domains and you want to use the same Swagger UI in the
+                browser to interact with each of them (instead of having multiple
+                browser tabs open). Or if you want to leave fixed the possible URLs.
+
+                If the servers `list` is not provided, or is an empty `list`, the
+                default value would be a a `dict` with a `url` value of `/`.
+
+                Each item in the `list` is a `dict` containing:
+
+                * `url`: A URL to the target host. This URL supports Server Variables
+                and MAY be relative, to indicate that the host location is relative
+                to the location where the OpenAPI document is being served. Variable
+                substitutions will be made when a variable is named in `{`brackets`}`.
+                * `description`: An optional string describing the host designated by
+                the URL. [CommonMark syntax](https://commonmark.org/) MAY be used for
+                rich text representation.
+                * `variables`: A `dict` between a variable name and its value. The value
+                    is used for substitution in the server's URL template.
+
+                Read more in the
+                [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/#additional-servers).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(
+                    servers=[
+                        {"url": "https://stag.example.com", "description": "Staging environment"},
+                        {"url": "https://prod.example.com", "description": "Production environment"},
+                    ]
+                )
+                ```
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of global dependencies, they will be applied to each
+                *path operation*, including in sub-routers.
+
+                Read more about it in the
+                [FastAPI docs for Global Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/global-dependencies/).
+
+                **Example**
+
+                ```python
+                from fastapi import Depends, FastAPI
+
+                from .dependencies import func_dep_1, func_dep_2
+
+                app = FastAPI(dependencies=[Depends(func_dep_1), Depends(func_dep_2)])
+                ```
+                """
+            ),
+        ] = None,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                The default response class to be used.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+                from fastapi.responses import ORJSONResponse
+
+                app = FastAPI(default_response_class=ORJSONResponse)
+                ```
+                """
+            ),
+        ] = Default(JSONResponse),
+        redirect_slashes: Annotated[
+            bool,
+            Doc(
+                """
+                Whether to detect and redirect slashes in URLs when the client doesn't
+                use the same format.
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(redirect_slashes=True)  # the default
+
+                @app.get("/items/")
+                async def read_items():
+                    return [{"item_id": "Foo"}]
+                ```
+
+                With this app, if a client goes to `/items` (without a trailing slash),
+                they will be automatically redirected with an HTTP status code of 307
+                to `/items/`.
+                """
+            ),
+        ] = True,
+        docs_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The path to the automatic interactive API documentation.
+                It is handled in the browser by Swagger UI.
+
+                The default URL is `/docs`. You can disable it by setting it to `None`.
+
+                If `openapi_url` is set to `None`, this will be automatically disabled.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(docs_url="/documentation", redoc_url=None)
+                ```
+                """
+            ),
+        ] = "/docs",
+        redoc_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The path to the alternative automatic interactive API documentation
+                provided by ReDoc.
+
+                The default URL is `/redoc`. You can disable it by setting it to `None`.
+
+                If `openapi_url` is set to `None`, this will be automatically disabled.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(docs_url="/documentation", redoc_url="redocumentation")
+                ```
+                """
+            ),
+        ] = "/redoc",
+        swagger_ui_oauth2_redirect_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The OAuth2 redirect endpoint for the Swagger UI.
+
+                By default it is `/docs/oauth2-redirect`.
+
+                This is only used if you use OAuth2 (with the "Authorize" button)
+                with Swagger UI.
+                """
+            ),
+        ] = "/docs/oauth2-redirect",
+        swagger_ui_init_oauth: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                OAuth2 configuration for the Swagger UI, by default shown at `/docs`.
+
+                Read more about the available configuration options in the
+                [Swagger UI docs](https://swagger.io/docs/open-source-tools/swagger-ui/usage/oauth2/).
+                """
+            ),
+        ] = None,
+        middleware: Annotated[
+            Optional[Sequence[Middleware]],
+            Doc(
+                """
+                List of middleware to be added when creating the application.
+
+                In FastAPI you would normally do this with `app.add_middleware()`
+                instead.
+
+                Read more in the
+                [FastAPI docs for Middleware](https://fastapi.tiangolo.com/tutorial/middleware/).
+                """
+            ),
+        ] = None,
+        exception_handlers: Annotated[
+            Optional[
+                Dict[
+                    Union[int, Type[Exception]],
+                    Callable[[Request, Any], Coroutine[Any, Any, Response]],
+                ]
+            ],
+            Doc(
+                """
+                A dictionary with handlers for exceptions.
+
+                In FastAPI, you would normally use the decorator
+                `@app.exception_handler()`.
+
+                Read more in the
+                [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/).
+                """
+            ),
+        ] = None,
+        on_startup: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of startup event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        on_shutdown: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of shutdown event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        lifespan: Annotated[
+            Optional[Lifespan[AppType]],
+            Doc(
+                """
+                A `Lifespan` context manager handler. This replaces `startup` and
+                `shutdown` functions with a single context manager.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        terms_of_service: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A URL to the Terms of Service for your API.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more at the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                app = FastAPI(terms_of_service="http://example.com/terms/")
+                ```
+                """
+            ),
+        ] = None,
+        contact: Annotated[
+            Optional[Dict[str, Union[str, Any]]],
+            Doc(
+                """
+                A dictionary with the contact information for the exposed API.
+
+                It can contain several fields.
+
+                * `name`: (`str`) The name of the contact person/organization.
+                * `url`: (`str`) A URL pointing to the contact information. MUST be in
+                    the format of a URL.
+                * `email`: (`str`) The email address of the contact person/organization.
+                    MUST be in the format of an email address.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more at the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                app = FastAPI(
+                    contact={
+                        "name": "Deadpoolio the Amazing",
+                        "url": "http://x-force.example.com/contact/",
+                        "email": "dp@x-force.example.com",
+                    }
+                )
+                ```
+                """
+            ),
+        ] = None,
+        license_info: Annotated[
+            Optional[Dict[str, Union[str, Any]]],
+            Doc(
+                """
+                A dictionary with the license information for the exposed API.
+
+                It can contain several fields.
+
+                * `name`: (`str`) **REQUIRED** (if a `license_info` is set). The
+                    license name used for the API.
+                * `identifier`: (`str`) An [SPDX](https://spdx.dev/) license expression
+                    for the API. The `identifier` field is mutually exclusive of the `url`
+                    field. Available since OpenAPI 3.1.0, FastAPI 0.99.0.
+                * `url`: (`str`) A URL to the license used for the API. This MUST be
+                    the format of a URL.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more at the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                app = FastAPI(
+                    license_info={
+                        "name": "Apache 2.0",
+                        "url": "https://www.apache.org/licenses/LICENSE-2.0.html",
+                    }
+                )
+                ```
+                """
+            ),
+        ] = None,
+        openapi_prefix: Annotated[
+            str,
+            Doc(
+                """
+                A URL prefix for the OpenAPI URL.
+                """
+            ),
+            deprecated(
+                """
+                "openapi_prefix" has been deprecated in favor of "root_path", which
+                follows more closely the ASGI standard, is simpler, and more
+                automatic.
+                """
+            ),
+        ] = "",
+        root_path: Annotated[
+            str,
+            Doc(
+                """
+                A path prefix handled by a proxy that is not seen by the application
+                but is seen by external clients, which affects things like Swagger UI.
+
+                Read more about it at the
+                [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(root_path="/api/v1")
+                ```
+                """
+            ),
+        ] = "",
+        root_path_in_servers: Annotated[
+            bool,
+            Doc(
+                """
+                To disable automatically generating the URLs in the `servers` field
+                in the autogenerated OpenAPI using the `root_path`.
+
+                Read more about it in the
+                [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/#disable-automatic-server-from-root_path).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(root_path_in_servers=False)
+                ```
+                """
+            ),
+        ] = True,
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                OpenAPI callbacks that should apply to all *path operations*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        webhooks: Annotated[
+            Optional[routing.APIRouter],
+            Doc(
+                """
+                Add OpenAPI webhooks. This is similar to `callbacks` but it doesn't
+                depend on specific *path operations*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                **Note**: This is available since OpenAPI 3.1.0, FastAPI 0.99.0.
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all *path operations* as deprecated. You probably don't need it,
+                but it's available.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                To include (or not) all the *path operations* in the generated OpenAPI.
+                You probably don't need it, but it's available.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        swagger_ui_parameters: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Parameters to configure Swagger UI, the autogenerated interactive API
+                documentation (by default at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs about how to Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
+        separate_input_output_schemas: Annotated[
+            bool,
+            Doc(
+                """
+                Whether to generate separate OpenAPI schemas for request body and
+                response body when the results would be more precise.
+
+                This is particularly useful when automatically generating clients.
+
+                For example, if you have a model like:
+
+                ```python
+                from pydantic import BaseModel
+
+                class Item(BaseModel):
+                    name: str
+                    tags: list[str] = []
+                ```
+
+                When `Item` is used for input, a request body, `tags` is not required,
+                the client doesn't have to provide it.
+
+                But when using `Item` for output, for a response body, `tags` is always
+                available because it has a default value, even if it's just an empty
+                list. So, the client should be able to always expect it.
+
+                In this case, there would be two different schemas, one for input and
+                another one for output.
+                """
+            ),
+        ] = True,
+        **extra: Annotated[
+            Any,
+            Doc(
+                """
+                Extra keyword arguments to be stored in the app, not used by FastAPI
+                anywhere.
+                """
+            ),
+        ],
     ) -> None:
         self.debug = debug
         self.title = title
@@ -111,8 +840,39 @@ class FastAPI(Starlette):
         self.swagger_ui_init_oauth = swagger_ui_init_oauth
         self.swagger_ui_parameters = swagger_ui_parameters
         self.servers = servers or []
+        self.separate_input_output_schemas = separate_input_output_schemas
         self.extra = extra
-        self.openapi_version = "3.1.0"
+        self.openapi_version: Annotated[
+            str,
+            Doc(
+                """
+                The version string of OpenAPI.
+
+                FastAPI will generate OpenAPI version 3.1.0, and will output that as
+                the OpenAPI version. But some tools, even though they might be
+                compatible with OpenAPI 3.1.0, might not recognize it as a valid.
+
+                So you could override this value to trick those tools into using
+                the generated OpenAPI. Have in mind that this is a hack. But if you
+                avoid using features added in OpenAPI 3.1.0, it might work for your
+                use case.
+
+                This is not passed as a parameter to the `FastAPI` class to avoid
+                giving the false idea that FastAPI would generate a different OpenAPI
+                schema. It is only available as an attribute.
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI()
+
+                app.openapi_version = "3.0.2"
+                ```
+                """
+            ),
+        ] = "3.1.0"
         self.openapi_schema: Optional[Dict[str, Any]] = None
         if self.openapi_url:
             assert self.title, "A title must be provided for OpenAPI, e.g.: 'My API'"
@@ -125,10 +885,53 @@ class FastAPI(Starlette):
                 "automatic. Check the docs at "
                 "https://fastapi.tiangolo.com/advanced/sub-applications/"
             )
-        self.webhooks = webhooks or routing.APIRouter()
+        self.webhooks: Annotated[
+            routing.APIRouter,
+            Doc(
+                """
+                The `app.webhooks` attribute is an `APIRouter` with the *path
+                operations* that will be used just for documentation of webhooks.
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/).
+                """
+            ),
+        ] = webhooks or routing.APIRouter()
         self.root_path = root_path or openapi_prefix
-        self.state: State = State()
-        self.dependency_overrides: Dict[Callable[..., Any], Callable[..., Any]] = {}
+        self.state: Annotated[
+            State,
+            Doc(
+                """
+                A state object for the application. This is the same object for the
+                entire application, it doesn't change from request to request.
+
+                You normally woudln't use this in FastAPI, for most of the cases you
+                would instead use FastAPI dependencies.
+
+                This is simply inherited from Starlette.
+
+                Read more about it in the
+                [Starlette docs for Applications](https://www.starlette.io/applications/#storing-state-on-the-app-instance).
+                """
+            ),
+        ] = State()
+        self.dependency_overrides: Annotated[
+            Dict[Callable[..., Any], Callable[..., Any]],
+            Doc(
+                """
+                A dictionary with overrides for the dependencies.
+
+                Each key is the original dependency callable, and the value is the
+                actual dependency that should be called.
+
+                This is for testing, to replace expensive dependencies with testing
+                versions.
+
+                Read more about it in the
+                [FastAPI docs for Testing Dependencies with Overrides](https://fastapi.tiangolo.com/advanced/testing-dependencies/).
+                """
+            ),
+        ] = {}
         self.router: routing.APIRouter = routing.APIRouter(
             routes=routes,
             redirect_slashes=redirect_slashes,
@@ -146,7 +949,7 @@ class FastAPI(Starlette):
         )
         self.exception_handlers: Dict[
             Any, Callable[[Request, Any], Union[Response, Awaitable[Response]]]
-        ] = ({} if exception_handlers is None else dict(exception_handlers))
+        ] = {} if exception_handlers is None else dict(exception_handlers)
         self.exception_handlers.setdefault(HTTPException, http_exception_handler)
         self.exception_handlers.setdefault(
             RequestValidationError, request_validation_exception_handler
@@ -187,20 +990,20 @@ class FastAPI(Starlette):
                 # contextvars.
                 # This needs to happen after user middlewares because those create a
                 # new contextvars context copy by using a new AnyIO task group.
-                # The initial part of dependencies with yield is executed in the
-                # FastAPI code, inside all the middlewares, but the teardown part
-                # (after yield) is executed in the AsyncExitStack in this middleware,
-                # if the AsyncExitStack lived outside of the custom middlewares and
-                # contextvars were set in a dependency with yield in that internal
+                # The initial part of dependencies with 'yield' is executed in the
+                # FastAPI code, inside all the middlewares. However, the teardown part
+                # (after 'yield') is executed in the AsyncExitStack in this middleware.
+                # If the AsyncExitStack lived outside of the custom middlewares and
+                # contextvars were set in a dependency with 'yield' in that internal
                 # contextvars context, the values would not be available in the
-                # outside context of the AsyncExitStack.
-                # By putting the middleware and the AsyncExitStack here, inside all
-                # user middlewares, the code before and after yield in dependencies
-                # with yield is executed in the same contextvars context, so all values
-                # set in contextvars before yield is still available after yield as
-                # would be expected.
+                # outer context of the AsyncExitStack.
+                # By placing the middleware and the AsyncExitStack here, inside all
+                # user middlewares, the code before and after 'yield' in dependencies
+                # with 'yield' is executed in the same contextvars context. Thus, all values
+                # set in contextvars before 'yield' are still available after 'yield,' as
+                # expected.
                 # Additionally, by having this AsyncExitStack here, after the
-                # ExceptionMiddleware, now dependencies can catch handled exceptions,
+                # ExceptionMiddleware, dependencies can now catch handled exceptions,
                 # e.g. HTTPException, to customize the teardown code (e.g. DB session
                 # rollback).
                 Middleware(AsyncExitStackMiddleware),
@@ -213,6 +1016,19 @@ class FastAPI(Starlette):
         return app
 
     def openapi(self) -> Dict[str, Any]:
+        """
+        Generate the OpenAPI schema of the application. This is called by FastAPI
+        internally.
+
+        The first time it is called it stores the result in the attribute
+        `app.openapi_schema`, and next times it is called, it just returns that same
+        result. To avoid the cost of generating the schema every time.
+
+        If you need to modify the generated OpenAPI schema, you could modify it.
+
+        Read more in the
+        [FastAPI docs for OpenAPI](https://fastapi.tiangolo.com/how-to/extending-openapi/).
+        """
         if not self.openapi_schema:
             self.openapi_schema = get_openapi(
                 title=self.title,
@@ -227,6 +1043,7 @@ class FastAPI(Starlette):
                 webhooks=self.webhooks.routes,
                 tags=self.openapi_tags,
                 servers=self.servers,
+                separate_input_output_schemas=self.separate_input_output_schemas,
             )
         return self.openapi_schema
 
@@ -424,11 +1241,58 @@ class FastAPI(Starlette):
 
     def websocket(
         self,
-        path: str,
-        name: Optional[str] = None,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                WebSocket path.
+                """
+            ),
+        ],
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A name for the WebSocket. Only used internally.
+                """
+            ),
+        ] = None,
         *,
-        dependencies: Optional[Sequence[Depends]] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be used for this
+                WebSocket.
+
+                Read more about it in the
+                [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+                """
+            ),
+        ] = None,
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Decorate a WebSocket function.
+
+        Read more about it in the
+        [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+
+        **Example**
+
+        ```python
+        from fastapi import FastAPI, WebSocket
+
+        app = FastAPI()
+
+        @app.websocket("/ws")
+        async def websocket_endpoint(websocket: WebSocket):
+            await websocket.accept()
+            while True:
+                data = await websocket.receive_text()
+                await websocket.send_text(f"Message text was: {data}")
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_api_websocket_route(
                 path,
@@ -442,20 +1306,196 @@ class FastAPI(Starlette):
 
     def include_router(
         self,
-        router: routing.APIRouter,
+        router: Annotated[routing.APIRouter, Doc("The `APIRouter` to include.")],
         *,
-        prefix: str = "",
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        callbacks: Optional[List[BaseRoute]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "",
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to all the *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to all the
+                *path operations* in this router.
+
+                Read more about it in the
+                [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+
+                **Example**
+
+                ```python
+                from fastapi import Depends, FastAPI
+
+                from .dependencies import get_token_header
+                from .internal import admin
+
+                app = FastAPI()
+
+                app.include_router(
+                    admin.router,
+                    dependencies=[Depends(get_token_header)],
+                )
+                ```
+                """
+            ),
+        ] = None,
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all the *path operations* in this router as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                from .internal import old_api
+
+                app = FastAPI()
+
+                app.include_router(
+                    old_api.router,
+                    deprecated=True,
+                )
+                ```
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include (or not) all the *path operations* in this router in the
+                generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                from .internal import old_api
+
+                app = FastAPI()
+
+                app.include_router(
+                    old_api.router,
+                    include_in_schema=False,
+                )
+                ```
+                """
+            ),
+        ] = True,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Default response class to be used for the *path operations* in this
+                router.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+                from fastapi.responses import ORJSONResponse
+
+                from .internal import old_api
+
+                app = FastAPI()
+
+                app.include_router(
+                    old_api.router,
+                    default_response_class=ORJSONResponse,
+                )
+                ```
+                """
+            ),
+        ] = Default(JSONResponse),
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> None:
+        """
+        Include an `APIRouter` in the same app.
+
+        Read more about it in the
+        [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/).
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        from .users import users_router
+
+        app = FastAPI()
+
+        app.include_router(users_router)
+        ```
+        """
         self.router.include_router(
             router,
             prefix=prefix,
@@ -471,33 +1511,351 @@ class FastAPI(Starlette):
 
     def get(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP GET operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.get("/items/")
+        def read_items():
+            return [{"name": "Empanada"}, {"name": "Arepa"}]
+        ```
+        """
         return self.router.get(
             path,
             response_model=response_model,
@@ -526,33 +1884,356 @@ class FastAPI(Starlette):
 
     def put(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PUT operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+
+        @app.put("/items/{item_id}")
+        def replace_item(item_id: str, item: Item):
+            return {"message": "Item replaced", "id": item_id}
+        ```
+        """
         return self.router.put(
             path,
             response_model=response_model,
@@ -581,33 +2262,356 @@ class FastAPI(Starlette):
 
     def post(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP POST operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+
+        @app.post("/items/")
+        def create_item(item: Item):
+            return {"message": "Item created"}
+        ```
+        """
         return self.router.post(
             path,
             response_model=response_model,
@@ -636,33 +2640,351 @@ class FastAPI(Starlette):
 
     def delete(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP DELETE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.delete("/items/{item_id}")
+        def delete_item(item_id: str):
+            return {"message": "Item deleted"}
+        ```
+        """
         return self.router.delete(
             path,
             response_model=response_model,
@@ -691,33 +3013,351 @@ class FastAPI(Starlette):
 
     def options(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP OPTIONS operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.options("/items/")
+        def get_item_options():
+            return {"additions": ["Aji", "Guacamole"]}
+        ```
+        """
         return self.router.options(
             path,
             response_model=response_model,
@@ -746,33 +3386,351 @@ class FastAPI(Starlette):
 
     def head(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP HEAD operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI, Response
+
+        app = FastAPI()
+
+        @app.head("/items/", status_code=204)
+        def get_items_headers(response: Response):
+            response.headers["X-Cat-Dog"] = "Alone in the world"
+        ```
+        """
         return self.router.head(
             path,
             response_model=response_model,
@@ -801,33 +3759,356 @@ class FastAPI(Starlette):
 
     def patch(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PATCH operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+
+        @app.patch("/items/")
+        def update_item(item: Item):
+            return {"message": "Item updated in place"}
+        ```
+        """
         return self.router.patch(
             path,
             response_model=response_model,
@@ -856,33 +4137,351 @@ class FastAPI(Starlette):
 
     def trace(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP TRACE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.put("/items/{item_id}")
+        def trace_item(item_id: str):
+            return None
+        ```
+        """
         return self.router.trace(
             path,
             response_model=response_model,
@@ -918,14 +4517,72 @@ class FastAPI(Starlette):
 
         return decorator
 
+    @deprecated(
+        """
+        on_event is deprecated, use lifespan event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/).
+        """
+    )
     def on_event(
-        self, event_type: str
+        self,
+        event_type: Annotated[
+            str,
+            Doc(
+                """
+                The type of event. `startup` or `shutdown`.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add an event handler for the application.
+
+        `on_event` is deprecated, use `lifespan` event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/#alternative-events-deprecated).
+        """
         return self.router.on_event(event_type)
 
     def middleware(
-        self, middleware_type: str
+        self,
+        middleware_type: Annotated[
+            str,
+            Doc(
+                """
+                The type of middleware. Currently only supports `http`.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a middleware to the application.
+
+        Read more about it in the
+        [FastAPI docs for Middleware](https://fastapi.tiangolo.com/tutorial/middleware/).
+
+        ## Example
+
+        ```python
+        import time
+
+        from fastapi import FastAPI, Request
+
+        app = FastAPI()
+
+
+        @app.middleware("http")
+        async def add_process_time_header(request: Request, call_next):
+            start_time = time.time()
+            response = await call_next(request)
+            process_time = time.time() - start_time
+            response.headers["X-Process-Time"] = str(process_time)
+            return response
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_middleware(BaseHTTPMiddleware, dispatch=func)
             return func
@@ -933,8 +4590,46 @@ class FastAPI(Starlette):
         return decorator
 
     def exception_handler(
-        self, exc_class_or_status_code: Union[int, Type[Exception]]
+        self,
+        exc_class_or_status_code: Annotated[
+            Union[int, Type[Exception]],
+            Doc(
+                """
+                The Exception class this would handle, or a status code.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add an exception handler to the app.
+
+        Read more about it in the
+        [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/).
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI, Request
+        from fastapi.responses import JSONResponse
+
+
+        class UnicornException(Exception):
+            def __init__(self, name: str):
+                self.name = name
+
+
+        app = FastAPI()
+
+
+        @app.exception_handler(UnicornException)
+        async def unicorn_exception_handler(request: Request, exc: UnicornException):
+            return JSONResponse(
+                status_code=418,
+                content={"message": f"Oops! {exc.name} did something. There goes a rainbow..."},
+            )
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_exception_handler(exc_class_or_status_code, func)
             return func
diff --git a/fastapi/background.py b/fastapi/background.py
index dd3bbe249..35ab1b227 100644
--- a/fastapi/background.py
+++ b/fastapi/background.py
@@ -1 +1,59 @@
-from starlette.background import BackgroundTasks as BackgroundTasks  # noqa
+from typing import Any, Callable
+
+from starlette.background import BackgroundTasks as StarletteBackgroundTasks
+from typing_extensions import Annotated, Doc, ParamSpec  # type: ignore [attr-defined]
+
+P = ParamSpec("P")
+
+
+class BackgroundTasks(StarletteBackgroundTasks):
+    """
+    A collection of background tasks that will be called after a response has been
+    sent to the client.
+
+    Read more about it in the
+    [FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/).
+
+    ## Example
+
+    ```python
+    from fastapi import BackgroundTasks, FastAPI
+
+    app = FastAPI()
+
+
+    def write_notification(email: str, message=""):
+        with open("log.txt", mode="w") as email_file:
+            content = f"notification for {email}: {message}"
+            email_file.write(content)
+
+
+    @app.post("/send-notification/{email}")
+    async def send_notification(email: str, background_tasks: BackgroundTasks):
+        background_tasks.add_task(write_notification, email, message="some notification")
+        return {"message": "Notification sent in the background"}
+    ```
+    """
+
+    def add_task(
+        self,
+        func: Annotated[
+            Callable[P, Any],
+            Doc(
+                """
+                The function to call after the response is sent.
+
+                It can be a regular `def` function or an `async def` function.
+                """
+            ),
+        ],
+        *args: P.args,
+        **kwargs: P.kwargs,
+    ) -> None:
+        """
+        Add a function to be called in the background after the response is sent.
+
+        Read more about it in the
+        [FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/).
+        """
+        return super().add_task(func, *args, **kwargs)
diff --git a/fastapi/concurrency.py b/fastapi/concurrency.py
index 31b878d5d..754061c86 100644
--- a/fastapi/concurrency.py
+++ b/fastapi/concurrency.py
@@ -19,7 +19,7 @@ async def contextmanager_in_threadpool(
 ) -> AsyncGenerator[_T, None]:
     # blocking __exit__ from running waiting on a free thread
     # can create race conditions/deadlocks if the context manager itself
-    # has it's own internal pool (e.g. a database connection pool)
+    # has its own internal pool (e.g. a database connection pool)
     # to avoid this we let __exit__ run without a capacity limit
     # since we're creating a new limiter for each call, any non-zero limit
     # works (1 is arbitrary)
diff --git a/fastapi/datastructures.py b/fastapi/datastructures.py
index 3c96c56c7..ce03e3ce4 100644
--- a/fastapi/datastructures.py
+++ b/fastapi/datastructures.py
@@ -1,11 +1,21 @@
-from typing import Any, Callable, Dict, Iterable, Type, TypeVar, cast
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    Dict,
+    Iterable,
+    Optional,
+    Type,
+    TypeVar,
+    cast,
+)
 
 from fastapi._compat import (
     PYDANTIC_V2,
     CoreSchema,
     GetJsonSchemaHandler,
     JsonSchemaValue,
-    general_plain_validator_function,
+    with_info_plain_validator_function,
 )
 from starlette.datastructures import URL as URL  # noqa: F401
 from starlette.datastructures import Address as Address  # noqa: F401
@@ -14,9 +24,120 @@ from starlette.datastructures import Headers as Headers  # noqa: F401
 from starlette.datastructures import QueryParams as QueryParams  # noqa: F401
 from starlette.datastructures import State as State  # noqa: F401
 from starlette.datastructures import UploadFile as StarletteUploadFile
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class UploadFile(StarletteUploadFile):
+    """
+    A file uploaded in a request.
+
+    Define it as a *path operation function* (or dependency) parameter.
+
+    If you are using a regular `def` function, you can use the `upload_file.file`
+    attribute to access the raw standard Python file (blocking, not async), useful and
+    needed for non-async code.
+
+    Read more about it in the
+    [FastAPI docs for Request Files](https://fastapi.tiangolo.com/tutorial/request-files/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import FastAPI, File, UploadFile
+
+    app = FastAPI()
+
+
+    @app.post("/files/")
+    async def create_file(file: Annotated[bytes, File()]):
+        return {"file_size": len(file)}
+
+
+    @app.post("/uploadfile/")
+    async def create_upload_file(file: UploadFile):
+        return {"filename": file.filename}
+    ```
+    """
+
+    file: Annotated[
+        BinaryIO,
+        Doc("The standard Python file object (non-async)."),
+    ]
+    filename: Annotated[Optional[str], Doc("The original file name.")]
+    size: Annotated[Optional[int], Doc("The size of the file in bytes.")]
+    headers: Annotated[Headers, Doc("The headers of the request.")]
+    content_type: Annotated[
+        Optional[str], Doc("The content type of the request, from the headers.")
+    ]
+
+    async def write(
+        self,
+        data: Annotated[
+            bytes,
+            Doc(
+                """
+                The bytes to write to the file.
+                """
+            ),
+        ],
+    ) -> None:
+        """
+        Write some bytes to the file.
+
+        You normally wouldn't use this from a file you read in a request.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().write(data)
+
+    async def read(
+        self,
+        size: Annotated[
+            int,
+            Doc(
+                """
+                The number of bytes to read from the file.
+                """
+            ),
+        ] = -1,
+    ) -> bytes:
+        """
+        Read some bytes from the file.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().read(size)
+
+    async def seek(
+        self,
+        offset: Annotated[
+            int,
+            Doc(
+                """
+                The position in bytes to seek to in the file.
+                """
+            ),
+        ],
+    ) -> None:
+        """
+        Move to a position in the file.
+
+        Any next read or write will be done from that position.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().seek(offset)
+
+    async def close(self) -> None:
+        """
+        Close the file.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().close()
+
     @classmethod
     def __get_validators__(cls: Type["UploadFile"]) -> Iterable[Callable[..., Any]]:
         yield cls.validate
@@ -49,7 +170,7 @@ class UploadFile(StarletteUploadFile):
     def __get_pydantic_core_schema__(
         cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
     ) -> CoreSchema:
-        return general_plain_validator_function(cls._validate)
+        return with_info_plain_validator_function(cls._validate)
 
 
 class DefaultPlaceholder:
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index e2915268c..96e07a45c 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -44,6 +44,7 @@ from fastapi._compat import (
     serialize_sequence_value,
     value_is_sequence,
 )
+from fastapi.background import BackgroundTasks
 from fastapi.concurrency import (
     AsyncExitStack,
     asynccontextmanager,
@@ -56,7 +57,7 @@ from fastapi.security.oauth2 import OAuth2, SecurityScopes
 from fastapi.security.open_id_connect_url import OpenIdConnect
 from fastapi.utils import create_response_field, get_path_param_names
 from pydantic.fields import FieldInfo
-from starlette.background import BackgroundTasks
+from starlette.background import BackgroundTasks as StarletteBackgroundTasks
 from starlette.concurrency import run_in_threadpool
 from starlette.datastructures import FormData, Headers, QueryParams, UploadFile
 from starlette.requests import HTTPConnection, Request
@@ -305,7 +306,7 @@ def add_non_field_param_to_dependency(
     elif lenient_issubclass(type_annotation, Response):
         dependant.response_param_name = param_name
         return True
-    elif lenient_issubclass(type_annotation, BackgroundTasks):
+    elif lenient_issubclass(type_annotation, StarletteBackgroundTasks):
         dependant.background_tasks_param_name = param_name
         return True
     elif lenient_issubclass(type_annotation, SecurityScopes):
@@ -382,7 +383,14 @@ def analyze_param(
 
     if lenient_issubclass(
         type_annotation,
-        (Request, WebSocket, HTTPConnection, Response, BackgroundTasks, SecurityScopes),
+        (
+            Request,
+            WebSocket,
+            HTTPConnection,
+            Response,
+            StarletteBackgroundTasks,
+            SecurityScopes,
+        ),
     ):
         assert depends is None, f"Cannot specify `Depends` for type {type_annotation!r}"
         assert (
@@ -510,14 +518,14 @@ async def solve_dependencies(
     request: Union[Request, WebSocket],
     dependant: Dependant,
     body: Optional[Union[Dict[str, Any], FormData]] = None,
-    background_tasks: Optional[BackgroundTasks] = None,
+    background_tasks: Optional[StarletteBackgroundTasks] = None,
     response: Optional[Response] = None,
     dependency_overrides_provider: Optional[Any] = None,
     dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None,
 ) -> Tuple[
     Dict[str, Any],
     List[Any],
-    Optional[BackgroundTasks],
+    Optional[StarletteBackgroundTasks],
     Response,
     Dict[Tuple[Callable[..., Any], Tuple[str]], Any],
 ]:
diff --git a/fastapi/encoders.py b/fastapi/encoders.py
index b542749f2..e50171393 100644
--- a/fastapi/encoders.py
+++ b/fastapi/encoders.py
@@ -20,10 +20,11 @@ from uuid import UUID
 from fastapi.types import IncEx
 from pydantic import BaseModel
 from pydantic.color import Color
-from pydantic.networks import NameEmail
+from pydantic.networks import AnyUrl, NameEmail
 from pydantic.types import SecretBytes, SecretStr
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
-from ._compat import PYDANTIC_V2, MultiHostUrl, Url, _model_dump
+from ._compat import PYDANTIC_V2, Url, _model_dump
 
 
 # Taken from Pydantic v1 as is
@@ -80,7 +81,7 @@ ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
     set: list,
     UUID: str,
     Url: str,
-    MultiHostUrl: str,
+    AnyUrl: str,
 }
 
 
@@ -99,16 +100,107 @@ encoders_by_class_tuples = generate_encoders_by_class_tuples(ENCODERS_BY_TYPE)
 
 
 def jsonable_encoder(
-    obj: Any,
-    include: Optional[IncEx] = None,
-    exclude: Optional[IncEx] = None,
-    by_alias: bool = True,
-    exclude_unset: bool = False,
-    exclude_defaults: bool = False,
-    exclude_none: bool = False,
-    custom_encoder: Optional[Dict[Any, Callable[[Any], Any]]] = None,
-    sqlalchemy_safe: bool = True,
+    obj: Annotated[
+        Any,
+        Doc(
+            """
+            The input object to convert to JSON.
+            """
+        ),
+    ],
+    include: Annotated[
+        Optional[IncEx],
+        Doc(
+            """
+            Pydantic's `include` parameter, passed to Pydantic models to set the
+            fields to include.
+            """
+        ),
+    ] = None,
+    exclude: Annotated[
+        Optional[IncEx],
+        Doc(
+            """
+            Pydantic's `exclude` parameter, passed to Pydantic models to set the
+            fields to exclude.
+            """
+        ),
+    ] = None,
+    by_alias: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `by_alias` parameter, passed to Pydantic models to define if
+            the output should use the alias names (when provided) or the Python
+            attribute names. In an API, if you set an alias, it's probably because you
+            want to use it in the result, so you probably want to leave this set to
+            `True`.
+            """
+        ),
+    ] = True,
+    exclude_unset: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `exclude_unset` parameter, passed to Pydantic models to define
+            if it should exclude from the output the fields that were not explicitly
+            set (and that only had their default values).
+            """
+        ),
+    ] = False,
+    exclude_defaults: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `exclude_defaults` parameter, passed to Pydantic models to define
+            if it should exclude from the output the fields that had the same default
+            value, even when they were explicitly set.
+            """
+        ),
+    ] = False,
+    exclude_none: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `exclude_none` parameter, passed to Pydantic models to define
+            if it should exclude from the output any fields that have a `None` value.
+            """
+        ),
+    ] = False,
+    custom_encoder: Annotated[
+        Optional[Dict[Any, Callable[[Any], Any]]],
+        Doc(
+            """
+            Pydantic's `custom_encoder` parameter, passed to Pydantic models to define
+            a custom encoder.
+            """
+        ),
+    ] = None,
+    sqlalchemy_safe: Annotated[
+        bool,
+        Doc(
+            """
+            Exclude from the output any fields that start with the name `_sa`.
+
+            This is mainly a hack for compatibility with SQLAlchemy objects, they
+            store internal SQLAlchemy-specific state in attributes named with `_sa`,
+            and those objects can't (and shouldn't be) serialized to JSON.
+            """
+        ),
+    ] = True,
 ) -> Any:
+    """
+    Convert any object to something that can be encoded in JSON.
+
+    This is used internally by FastAPI to make sure anything you return can be
+    encoded as JSON before it is sent to the client.
+
+    You can also use it yourself, for example to convert objects before saving them
+    in a database that supports only JSON.
+
+    Read more about it in the
+    [FastAPI docs for JSON Compatible Encoder](https://fastapi.tiangolo.com/tutorial/encoder/).
+    """
     custom_encoder = custom_encoder or {}
     if custom_encoder:
         if type(obj) in custom_encoder:
diff --git a/fastapi/exceptions.py b/fastapi/exceptions.py
index c1692f396..680d288e4 100644
--- a/fastapi/exceptions.py
+++ b/fastapi/exceptions.py
@@ -1,20 +1,141 @@
-from typing import Any, Dict, Optional, Sequence, Type
+from typing import Any, Dict, Optional, Sequence, Type, Union
 
 from pydantic import BaseModel, create_model
 from starlette.exceptions import HTTPException as StarletteHTTPException
-from starlette.exceptions import WebSocketException as WebSocketException  # noqa: F401
+from starlette.exceptions import WebSocketException as StarletteWebSocketException
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class HTTPException(StarletteHTTPException):
+    """
+    An HTTP exception you can raise in your own code to show errors to the client.
+
+    This is for client errors, invalid authentication, invalid data, etc. Not for server
+    errors in your code.
+
+    Read more about it in the
+    [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/).
+
+    ## Example
+
+    ```python
+    from fastapi import FastAPI, HTTPException
+
+    app = FastAPI()
+
+    items = {"foo": "The Foo Wrestlers"}
+
+
+    @app.get("/items/{item_id}")
+    async def read_item(item_id: str):
+        if item_id not in items:
+            raise HTTPException(status_code=404, detail="Item not found")
+        return {"item": items[item_id]}
+    ```
+    """
+
     def __init__(
         self,
-        status_code: int,
-        detail: Any = None,
-        headers: Optional[Dict[str, str]] = None,
+        status_code: Annotated[
+            int,
+            Doc(
+                """
+                HTTP status code to send to the client.
+                """
+            ),
+        ],
+        detail: Annotated[
+            Any,
+            Doc(
+                """
+                Any data to be sent to the client in the `detail` key of the JSON
+                response.
+                """
+            ),
+        ] = None,
+        headers: Annotated[
+            Optional[Dict[str, str]],
+            Doc(
+                """
+                Any headers to send to the client in the response.
+                """
+            ),
+        ] = None,
     ) -> None:
         super().__init__(status_code=status_code, detail=detail, headers=headers)
 
 
+class WebSocketException(StarletteWebSocketException):
+    """
+    A WebSocket exception you can raise in your own code to show errors to the client.
+
+    This is for client errors, invalid authentication, invalid data, etc. Not for server
+    errors in your code.
+
+    Read more about it in the
+    [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import (
+        Cookie,
+        FastAPI,
+        WebSocket,
+        WebSocketException,
+        status,
+    )
+
+    app = FastAPI()
+
+    @app.websocket("/items/{item_id}/ws")
+    async def websocket_endpoint(
+        *,
+        websocket: WebSocket,
+        session: Annotated[str | None, Cookie()] = None,
+        item_id: str,
+    ):
+        if session is None:
+            raise WebSocketException(code=status.WS_1008_POLICY_VIOLATION)
+        await websocket.accept()
+        while True:
+            data = await websocket.receive_text()
+            await websocket.send_text(f"Session cookie is: {session}")
+            await websocket.send_text(f"Message text was: {data}, for item ID: {item_id}")
+    ```
+    """
+
+    def __init__(
+        self,
+        code: Annotated[
+            int,
+            Doc(
+                """
+                A closing code from the
+                [valid codes defined in the specification](https://datatracker.ietf.org/doc/html/rfc6455#section-7.4.1).
+                """
+            ),
+        ],
+        reason: Annotated[
+            Union[str, None],
+            Doc(
+                """
+                The reason to close the WebSocket connection.
+
+                It is UTF-8-encoded data. The interpretation of the reason is up to the
+                application, it is not specified by the WebSocket specification.
+
+                It could contain text that could be human-readable or interpretable
+                by the client code, etc.
+                """
+            ),
+        ] = None,
+    ) -> None:
+        super().__init__(code=code, reason=reason)
+
+
 RequestErrorModel: Type[BaseModel] = create_model("Request")
 WebSocketErrorModel: Type[BaseModel] = create_model("WebSocket")
 
@@ -47,3 +168,9 @@ class ResponseValidationError(ValidationException):
     def __init__(self, errors: Sequence[Any], *, body: Any = None) -> None:
         super().__init__(errors)
         self.body = body
+
+    def __str__(self) -> str:
+        message = f"{len(self._errors)} validation errors:\n"
+        for err in self._errors:
+            message += f"  {err}\n"
+        return message
diff --git a/fastapi/openapi/docs.py b/fastapi/openapi/docs.py
index 81f67dcc5..69473d19c 100644
--- a/fastapi/openapi/docs.py
+++ b/fastapi/openapi/docs.py
@@ -3,8 +3,18 @@ from typing import Any, Dict, Optional
 
 from fastapi.encoders import jsonable_encoder
 from starlette.responses import HTMLResponse
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
-swagger_ui_default_parameters = {
+swagger_ui_default_parameters: Annotated[
+    Dict[str, Any],
+    Doc(
+        """
+        Default configurations for Swagger UI.
+
+        You can use it as a template to add any other configurations needed.
+        """
+    ),
+] = {
     "dom_id": "#swagger-ui",
     "layout": "BaseLayout",
     "deepLinking": True,
@@ -15,15 +25,91 @@ swagger_ui_default_parameters = {
 
 def get_swagger_ui_html(
     *,
-    openapi_url: str,
-    title: str,
-    swagger_js_url: str = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js",
-    swagger_css_url: str = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css",
-    swagger_favicon_url: str = "https://fastapi.tiangolo.com/img/favicon.png",
-    oauth2_redirect_url: Optional[str] = None,
-    init_oauth: Optional[Dict[str, Any]] = None,
-    swagger_ui_parameters: Optional[Dict[str, Any]] = None,
+    openapi_url: Annotated[
+        str,
+        Doc(
+            """
+            The OpenAPI URL that Swagger UI should load and use.
+
+            This is normally done automatically by FastAPI using the default URL
+            `/openapi.json`.
+            """
+        ),
+    ],
+    title: Annotated[
+        str,
+        Doc(
+            """
+            The HTML `<title>` content, normally shown in the browser tab.
+            """
+        ),
+    ],
+    swagger_js_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL to use to load the Swagger UI JavaScript.
+
+            It is normally set to a CDN URL.
+            """
+        ),
+    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui-bundle.js",
+    swagger_css_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL to use to load the Swagger UI CSS.
+
+            It is normally set to a CDN URL.
+            """
+        ),
+    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui.css",
+    swagger_favicon_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL of the favicon to use. It is normally shown in the browser tab.
+            """
+        ),
+    ] = "https://fastapi.tiangolo.com/img/favicon.png",
+    oauth2_redirect_url: Annotated[
+        Optional[str],
+        Doc(
+            """
+            The OAuth2 redirect URL, it is normally automatically handled by FastAPI.
+            """
+        ),
+    ] = None,
+    init_oauth: Annotated[
+        Optional[Dict[str, Any]],
+        Doc(
+            """
+            A dictionary with Swagger UI OAuth2 initialization configurations.
+            """
+        ),
+    ] = None,
+    swagger_ui_parameters: Annotated[
+        Optional[Dict[str, Any]],
+        Doc(
+            """
+            Configuration parameters for Swagger UI.
+
+            It defaults to [swagger_ui_default_parameters][fastapi.openapi.docs.swagger_ui_default_parameters].
+            """
+        ),
+    ] = None,
 ) -> HTMLResponse:
+    """
+    Generate and return the HTML  that loads Swagger UI for the interactive
+    API docs (normally served at `/docs`).
+
+    You would only call this function yourself if you needed to override some parts,
+    for example the URLs to use to load Swagger UI's JavaScript and CSS.
+
+    Read more about it in the
+    [FastAPI docs for Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/)
+    and the [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/).
+    """
     current_swagger_ui_parameters = swagger_ui_default_parameters.copy()
     if swagger_ui_parameters:
         current_swagger_ui_parameters.update(swagger_ui_parameters)
@@ -74,12 +160,62 @@ def get_swagger_ui_html(
 
 def get_redoc_html(
     *,
-    openapi_url: str,
-    title: str,
-    redoc_js_url: str = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js",
-    redoc_favicon_url: str = "https://fastapi.tiangolo.com/img/favicon.png",
-    with_google_fonts: bool = True,
+    openapi_url: Annotated[
+        str,
+        Doc(
+            """
+            The OpenAPI URL that ReDoc should load and use.
+
+            This is normally done automatically by FastAPI using the default URL
+            `/openapi.json`.
+            """
+        ),
+    ],
+    title: Annotated[
+        str,
+        Doc(
+            """
+            The HTML `<title>` content, normally shown in the browser tab.
+            """
+        ),
+    ],
+    redoc_js_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL to use to load the ReDoc JavaScript.
+
+            It is normally set to a CDN URL.
+            """
+        ),
+    ] = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js",
+    redoc_favicon_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL of the favicon to use. It is normally shown in the browser tab.
+            """
+        ),
+    ] = "https://fastapi.tiangolo.com/img/favicon.png",
+    with_google_fonts: Annotated[
+        bool,
+        Doc(
+            """
+            Load and use Google Fonts.
+            """
+        ),
+    ] = True,
 ) -> HTMLResponse:
+    """
+    Generate and return the HTML response that loads ReDoc for the alternative
+    API docs (normally served at `/redoc`).
+
+    You would only call this function yourself if you needed to override some parts,
+    for example the URLs to use to load ReDoc's JavaScript and CSS.
+
+    Read more about it in the
+    [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/).
+    """
     html = f"""
     <!DOCTYPE html>
     <html>
@@ -118,6 +254,11 @@ def get_redoc_html(
 
 
 def get_swagger_ui_oauth2_redirect_html() -> HTMLResponse:
+    """
+    Generate the HTML response with the OAuth2 redirection for Swagger UI.
+
+    You normally don't need to use or change this.
+    """
     # copied from https://github.com/swagger-api/swagger-ui/blob/v4.14.0/dist/oauth2-redirect.html
     html = """
     <!doctype html>
diff --git a/fastapi/openapi/models.py b/fastapi/openapi/models.py
index 2268dd229..5f3bdbb20 100644
--- a/fastapi/openapi/models.py
+++ b/fastapi/openapi/models.py
@@ -7,11 +7,11 @@ from fastapi._compat import (
     GetJsonSchemaHandler,
     JsonSchemaValue,
     _model_rebuild,
-    general_plain_validator_function,
+    with_info_plain_validator_function,
 )
 from fastapi.logger import logger
 from pydantic import AnyUrl, BaseModel, Field
-from typing_extensions import Annotated, Literal
+from typing_extensions import Annotated, Literal, TypedDict
 from typing_extensions import deprecated as typing_deprecated
 
 try:
@@ -52,7 +52,7 @@ except ImportError:  # pragma: no cover
         def __get_pydantic_core_schema__(
             cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
         ) -> CoreSchema:
-            return general_plain_validator_function(cls._validate)
+            return with_info_plain_validator_function(cls._validate)
 
 
 class Contact(BaseModel):
@@ -267,14 +267,14 @@ class Schema(BaseModel):
 SchemaOrBool = Union[Schema, bool]
 
 
-class Example(BaseModel):
-    summary: Optional[str] = None
-    description: Optional[str] = None
-    value: Optional[Any] = None
-    externalValue: Optional[AnyUrl] = None
+class Example(TypedDict, total=False):
+    summary: Optional[str]
+    description: Optional[str]
+    value: Optional[Any]
+    externalValue: Optional[AnyUrl]
 
-    if PYDANTIC_V2:
-        model_config = {"extra": "allow"}
+    if PYDANTIC_V2:  # type: ignore [misc]
+        __pydantic_config__ = {"extra": "allow"}
 
     else:
 
diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py
index e295361e6..5bfb5acef 100644
--- a/fastapi/openapi/utils.py
+++ b/fastapi/openapi/utils.py
@@ -95,6 +95,7 @@ def get_openapi_operation_parameters(
     field_mapping: Dict[
         Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
     ],
+    separate_input_output_schemas: bool = True,
 ) -> List[Dict[str, Any]]:
     parameters = []
     for param in all_route_params:
@@ -107,6 +108,7 @@ def get_openapi_operation_parameters(
             schema_generator=schema_generator,
             model_name_map=model_name_map,
             field_mapping=field_mapping,
+            separate_input_output_schemas=separate_input_output_schemas,
         )
         parameter = {
             "name": param.alias,
@@ -116,7 +118,9 @@ def get_openapi_operation_parameters(
         }
         if field_info.description:
             parameter["description"] = field_info.description
-        if field_info.example != Undefined:
+        if field_info.openapi_examples:
+            parameter["examples"] = jsonable_encoder(field_info.openapi_examples)
+        elif field_info.example != Undefined:
             parameter["example"] = jsonable_encoder(field_info.example)
         if field_info.deprecated:
             parameter["deprecated"] = field_info.deprecated
@@ -132,6 +136,7 @@ def get_openapi_operation_request_body(
     field_mapping: Dict[
         Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
     ],
+    separate_input_output_schemas: bool = True,
 ) -> Optional[Dict[str, Any]]:
     if not body_field:
         return None
@@ -141,6 +146,7 @@ def get_openapi_operation_request_body(
         schema_generator=schema_generator,
         model_name_map=model_name_map,
         field_mapping=field_mapping,
+        separate_input_output_schemas=separate_input_output_schemas,
     )
     field_info = cast(Body, body_field.field_info)
     request_media_type = field_info.media_type
@@ -149,7 +155,11 @@ def get_openapi_operation_request_body(
     if required:
         request_body_oai["required"] = required
     request_media_content: Dict[str, Any] = {"schema": body_schema}
-    if field_info.example != Undefined:
+    if field_info.openapi_examples:
+        request_media_content["examples"] = jsonable_encoder(
+            field_info.openapi_examples
+        )
+    elif field_info.example != Undefined:
         request_media_content["example"] = jsonable_encoder(field_info.example)
     request_body_oai["content"] = {request_media_type: request_media_content}
     return request_body_oai
@@ -211,6 +221,7 @@ def get_openapi_path(
     field_mapping: Dict[
         Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
     ],
+    separate_input_output_schemas: bool = True,
 ) -> Tuple[Dict[str, Any], Dict[str, Any], Dict[str, Any]]:
     path = {}
     security_schemes: Dict[str, Any] = {}
@@ -242,6 +253,7 @@ def get_openapi_path(
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
             )
             parameters.extend(operation_parameters)
             if parameters:
@@ -263,6 +275,7 @@ def get_openapi_path(
                     schema_generator=schema_generator,
                     model_name_map=model_name_map,
                     field_mapping=field_mapping,
+                    separate_input_output_schemas=separate_input_output_schemas,
                 )
                 if request_body_oai:
                     operation["requestBody"] = request_body_oai
@@ -280,6 +293,7 @@ def get_openapi_path(
                             schema_generator=schema_generator,
                             model_name_map=model_name_map,
                             field_mapping=field_mapping,
+                            separate_input_output_schemas=separate_input_output_schemas,
                         )
                         callbacks[callback.name] = {callback.path: cb_path}
                 operation["callbacks"] = callbacks
@@ -310,6 +324,7 @@ def get_openapi_path(
                             schema_generator=schema_generator,
                             model_name_map=model_name_map,
                             field_mapping=field_mapping,
+                            separate_input_output_schemas=separate_input_output_schemas,
                         )
                     else:
                         response_schema = {}
@@ -343,6 +358,7 @@ def get_openapi_path(
                             schema_generator=schema_generator,
                             model_name_map=model_name_map,
                             field_mapping=field_mapping,
+                            separate_input_output_schemas=separate_input_output_schemas,
                         )
                         media_type = route_response_media_type or "application/json"
                         additional_schema = (
@@ -433,6 +449,7 @@ def get_openapi(
     terms_of_service: Optional[str] = None,
     contact: Optional[Dict[str, Union[str, Any]]] = None,
     license_info: Optional[Dict[str, Union[str, Any]]] = None,
+    separate_input_output_schemas: bool = True,
 ) -> Dict[str, Any]:
     info: Dict[str, Any] = {"title": title, "version": version}
     if summary:
@@ -459,6 +476,7 @@ def get_openapi(
         fields=all_fields,
         schema_generator=schema_generator,
         model_name_map=model_name_map,
+        separate_input_output_schemas=separate_input_output_schemas,
     )
     for route in routes or []:
         if isinstance(route, routing.APIRoute):
@@ -468,6 +486,7 @@ def get_openapi(
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
             )
             if result:
                 path, security_schemes, path_definitions = result
@@ -487,6 +506,7 @@ def get_openapi(
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
             )
             if result:
                 path, security_schemes, path_definitions = result
diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index a43afaf31..3f6dbc959 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -2,43 +2,219 @@ from typing import Any, Callable, Dict, List, Optional, Sequence, Union
 
 from fastapi import params
 from fastapi._compat import Undefined
-from typing_extensions import Annotated, deprecated
+from fastapi.openapi.models import Example
+from typing_extensions import Annotated, Doc, deprecated  # type: ignore [attr-defined]
 
 _Unset: Any = Undefined
 
 
 def Path(  # noqa: N802
-    default: Any = ...,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = ...,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -46,11 +222,87 @@ def Path(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
+    """
+    Declare a path parameter for a *path operation*.
+
+    Read more about it in the
+    [FastAPI docs for Path Parameters and Numeric Validations](https://fastapi.tiangolo.com/tutorial/path-params-numeric-validations/).
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import FastAPI, Path
+
+    app = FastAPI()
+
+
+    @app.get("/items/{item_id}")
+    async def read_items(
+        item_id: Annotated[int, Path(title="The ID of the item to get")],
+    ):
+        return {"item_id": item_id}
+    ```
+    """
     return params.Path(
         default=default,
         default_factory=default_factory,
@@ -76,6 +328,7 @@ def Path(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -84,37 +337,209 @@ def Path(  # noqa: N802
 
 
 def Query(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -122,10 +547,65 @@ def Query(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Query(
         default=default,
@@ -152,6 +632,7 @@ def Query(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -160,38 +641,220 @@ def Query(  # noqa: N802
 
 
 def Header(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    convert_underscores: bool = True,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    convert_underscores: Annotated[
+        bool,
+        Doc(
+            """
+            Automatically convert underscores to hyphens in the parameter field name.
+
+            Read more about it in the
+            [FastAPI docs for Header Parameters](https://fastapi.tiangolo.com/tutorial/header-params/#automatic-conversion)
+            """
+        ),
+    ] = True,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -199,10 +862,65 @@ def Header(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Header(
         default=default,
@@ -230,6 +948,7 @@ def Header(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -238,37 +957,209 @@ def Header(  # noqa: N802
 
 
 def Cookie(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -276,10 +1167,65 @@ def Cookie(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Cookie(
         default=default,
@@ -306,6 +1252,7 @@ def Cookie(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -314,39 +1261,232 @@ def Cookie(  # noqa: N802
 
 
 def Body(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    embed: bool = False,
-    media_type: str = "application/json",
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    embed: Annotated[
+        bool,
+        Doc(
+            """
+            When `embed` is `True`, the parameter will be expected in a JSON body as a
+            key instead of being the JSON body itself.
+
+            This happens automatically when more than one `Body` parameter is declared.
+
+            Read more about it in the
+            [FastAPI docs for Body - Multiple Parameters](https://fastapi.tiangolo.com/tutorial/body-multiple-params/#embed-a-single-body-parameter).
+            """
+        ),
+    ] = False,
+    media_type: Annotated[
+        str,
+        Doc(
+            """
+            The media type of this parameter field. Changing it would affect the
+            generated OpenAPI, but currently it doesn't affect the parsing of the data.
+            """
+        ),
+    ] = "application/json",
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -354,10 +1494,65 @@ def Body(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Body(
         default=default,
@@ -386,6 +1581,7 @@ def Body(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -394,38 +1590,218 @@ def Body(  # noqa: N802
 
 
 def Form(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    media_type: str = "application/x-www-form-urlencoded",
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    media_type: Annotated[
+        str,
+        Doc(
+            """
+            The media type of this parameter field. Changing it would affect the
+            generated OpenAPI, but currently it doesn't affect the parsing of the data.
+            """
+        ),
+    ] = "application/x-www-form-urlencoded",
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -433,10 +1809,65 @@ def Form(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Form(
         default=default,
@@ -464,6 +1895,7 @@ def Form(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -472,38 +1904,218 @@ def Form(  # noqa: N802
 
 
 def File(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    media_type: str = "multipart/form-data",
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    media_type: Annotated[
+        str,
+        Doc(
+            """
+            The media type of this parameter field. Changing it would affect the
+            generated OpenAPI, but currently it doesn't affect the parsing of the data.
+            """
+        ),
+    ] = "multipart/form-data",
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -511,10 +2123,65 @@ def File(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.File(
         default=default,
@@ -542,6 +2209,7 @@ def File(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -550,15 +2218,143 @@ def File(  # noqa: N802
 
 
 def Depends(  # noqa: N802
-    dependency: Optional[Callable[..., Any]] = None, *, use_cache: bool = True
+    dependency: Annotated[
+        Optional[Callable[..., Any]],
+        Doc(
+            """
+            A "dependable" callable (like a function).
+
+            Don't call it directly, FastAPI will call it for you, just pass the object
+            directly.
+            """
+        ),
+    ] = None,
+    *,
+    use_cache: Annotated[
+        bool,
+        Doc(
+            """
+            By default, after a dependency is called the first time in a request, if
+            the dependency is declared again for the rest of the request (for example
+            if the dependency is needed by several dependencies), the value will be
+            re-used for the rest of the request.
+
+            Set `use_cache` to `False` to disable this behavior and ensure the
+            dependency is called again (if declared more than once) in the same request.
+            """
+        ),
+    ] = True,
 ) -> Any:
+    """
+    Declare a FastAPI dependency.
+
+    It takes a single "dependable" callable (like a function).
+
+    Don't call it directly, FastAPI will call it for you.
+
+    Read more about it in the
+    [FastAPI docs for Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/).
+
+    **Example**
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+
+    app = FastAPI()
+
+
+    async def common_parameters(q: str | None = None, skip: int = 0, limit: int = 100):
+        return {"q": q, "skip": skip, "limit": limit}
+
+
+    @app.get("/items/")
+    async def read_items(commons: Annotated[dict, Depends(common_parameters)]):
+        return commons
+    ```
+    """
     return params.Depends(dependency=dependency, use_cache=use_cache)
 
 
 def Security(  # noqa: N802
-    dependency: Optional[Callable[..., Any]] = None,
+    dependency: Annotated[
+        Optional[Callable[..., Any]],
+        Doc(
+            """
+            A "dependable" callable (like a function).
+
+            Don't call it directly, FastAPI will call it for you, just pass the object
+            directly.
+            """
+        ),
+    ] = None,
     *,
-    scopes: Optional[Sequence[str]] = None,
-    use_cache: bool = True,
+    scopes: Annotated[
+        Optional[Sequence[str]],
+        Doc(
+            """
+            OAuth2 scopes required for the *path operation* that uses this Security
+            dependency.
+
+            The term "scope" comes from the OAuth2 specification, it seems to be
+            intentionaly vague and interpretable. It normally refers to permissions,
+            in cases to roles.
+
+            These scopes are integrated with OpenAPI (and the API docs at `/docs`).
+            So they are visible in the OpenAPI specification.
+            )
+            """
+        ),
+    ] = None,
+    use_cache: Annotated[
+        bool,
+        Doc(
+            """
+            By default, after a dependency is called the first time in a request, if
+            the dependency is declared again for the rest of the request (for example
+            if the dependency is needed by several dependencies), the value will be
+            re-used for the rest of the request.
+
+            Set `use_cache` to `False` to disable this behavior and ensure the
+            dependency is called again (if declared more than once) in the same request.
+            """
+        ),
+    ] = True,
 ) -> Any:
+    """
+    Declare a FastAPI Security dependency.
+
+    The only difference with a regular dependency is that it can declare OAuth2
+    scopes that will be integrated with OpenAPI and the automatic UI docs (by default
+    at `/docs`).
+
+    It takes a single "dependable" callable (like a function).
+
+    Don't call it directly, FastAPI will call it for you.
+
+    Read more about it in the
+    [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/) and
+    in the
+    [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/).
+
+    **Example**
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+
+    from .db import User
+    from .security import get_current_active_user
+
+    app = FastAPI()
+
+    @app.get("/users/me/items/")
+    async def read_own_items(
+        current_user: Annotated[User, Security(get_current_active_user, scopes=["items"])]
+    ):
+        return [{"item_id": "Foo", "owner": current_user.username}]
+    ```
+    """
     return params.Security(dependency=dependency, scopes=scopes, use_cache=use_cache)
diff --git a/fastapi/params.py b/fastapi/params.py
index 30af5713e..b40944dba 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -2,6 +2,7 @@ import warnings
 from enum import Enum
 from typing import Any, Callable, Dict, List, Optional, Sequence, Union
 
+from fastapi.openapi.models import Example
 from pydantic.fields import FieldInfo
 from typing_extensions import Annotated, deprecated
 
@@ -61,6 +62,7 @@ class Param(FieldInfo):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -69,12 +71,13 @@ class Param(FieldInfo):
         self.deprecated = deprecated
         if example is not _Unset:
             warnings.warn(
-                "`example` has been depreacated, please use `examples` instead",
+                "`example` has been deprecated, please use `examples` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )
         self.example = example
         self.include_in_schema = include_in_schema
+        self.openapi_examples = openapi_examples
         kwargs = dict(
             default=default,
             default_factory=default_factory,
@@ -98,7 +101,7 @@ class Param(FieldInfo):
             kwargs["examples"] = examples
         if regex is not None:
             warnings.warn(
-                "`regex` has been depreacated, please use `pattern` instead",
+                "`regex` has been deprecated, please use `pattern` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )
@@ -170,6 +173,7 @@ class Path(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -204,6 +208,7 @@ class Path(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -254,6 +259,7 @@ class Query(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -286,6 +292,7 @@ class Query(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -337,6 +344,7 @@ class Header(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -370,6 +378,7 @@ class Header(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -420,6 +429,7 @@ class Cookie(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -452,6 +462,7 @@ class Cookie(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -502,6 +513,7 @@ class Body(FieldInfo):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -512,12 +524,13 @@ class Body(FieldInfo):
         self.deprecated = deprecated
         if example is not _Unset:
             warnings.warn(
-                "`example` has been depreacated, please use `examples` instead",
+                "`example` has been deprecated, please use `examples` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )
         self.example = example
         self.include_in_schema = include_in_schema
+        self.openapi_examples = openapi_examples
         kwargs = dict(
             default=default,
             default_factory=default_factory,
@@ -613,6 +626,7 @@ class Form(Body):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -647,6 +661,7 @@ class Form(Body):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -696,6 +711,7 @@ class File(Form):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -729,6 +745,7 @@ class File(Form):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
diff --git a/fastapi/responses.py b/fastapi/responses.py
index c0a13b755..6c8db6f33 100644
--- a/fastapi/responses.py
+++ b/fastapi/responses.py
@@ -21,12 +21,26 @@ except ImportError:  # pragma: nocover
 
 
 class UJSONResponse(JSONResponse):
+    """
+    JSON response using the high-performance ujson library to serialize data to JSON.
+
+    Read more about it in the
+    [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/).
+    """
+
     def render(self, content: Any) -> bytes:
         assert ujson is not None, "ujson must be installed to use UJSONResponse"
         return ujson.dumps(content, ensure_ascii=False).encode("utf-8")
 
 
 class ORJSONResponse(JSONResponse):
+    """
+    JSON response using the high-performance orjson library to serialize data to JSON.
+
+    Read more about it in the
+    [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/).
+    """
+
     def render(self, content: Any) -> bytes:
         assert orjson is not None, "orjson must be installed to use ORJSONResponse"
         return orjson.dumps(
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 14ae1dd72..22b0951a9 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -71,6 +71,7 @@ from starlette.routing import (
 from starlette.routing import Mount as Mount  # noqa
 from starlette.types import AppType, ASGIApp, Lifespan, Scope
 from starlette.websockets import WebSocket
+from typing_extensions import Annotated, Doc, deprecated  # type: ignore [attr-defined]
 
 
 def _prepare_response_content(
@@ -85,7 +86,7 @@ def _prepare_response_content(
         if read_with_orm_mode:
             # Let from_orm extract the data from this model instead of converting
             # it now to a dict.
-            # Otherwise there's no way to extract lazy data that requires attribute
+            # Otherwise, there's no way to extract lazy data that requires attribute
             # access instead of dict iteration, e.g. lazy relationships.
             return res
         return _model_dump(
@@ -462,9 +463,7 @@ class APIRoute(routing.Route):
             self.response_field = create_response_field(
                 name=response_name,
                 type_=self.response_model,
-                # TODO: This should actually set mode='serialization', just, that changes the schemas
-                # mode="serialization",
-                mode="validation",
+                mode="serialization",
             )
             # Create a clone of the field, so that a Pydantic submodel is not returned
             # as is just because it's an instance of a subclass of a more limited class
@@ -472,7 +471,7 @@ class APIRoute(routing.Route):
             # that doesn't have the hashed_password. But because it's a subclass, it
             # would pass the validation and be returned as is.
             # By being a new field, no inheritance will be passed as is. A new model
-            # will be always created.
+            # will always be created.
             # TODO: remove when deprecating Pydantic v1
             self.secure_cloned_response_field: Optional[
                 ModelField
@@ -535,30 +534,246 @@ class APIRoute(routing.Route):
 
 
 class APIRouter(routing.Router):
+    """
+    `APIRouter` class, used to group *path operations*, for example to structure
+    an app in multiple files. It would then be included in the `FastAPI` app, or
+    in another `APIRouter` (ultimately included in the app).
+
+    Read more about it in the
+    [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/).
+
+    ## Example
+
+    ```python
+    from fastapi import APIRouter, FastAPI
+
+    app = FastAPI()
+    router = APIRouter()
+
+
+    @router.get("/users/", tags=["users"])
+    async def read_users():
+        return [{"username": "Rick"}, {"username": "Morty"}]
+
+
+    app.include_router(router)
+    ```
+    """
+
     def __init__(
         self,
         *,
-        prefix: str = "",
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        routes: Optional[List[routing.BaseRoute]] = None,
-        redirect_slashes: bool = True,
-        default: Optional[ASGIApp] = None,
-        dependency_overrides_provider: Optional[Any] = None,
-        route_class: Type[APIRoute] = APIRoute,
-        on_startup: Optional[Sequence[Callable[[], Any]]] = None,
-        on_shutdown: Optional[Sequence[Callable[[], Any]]] = None,
+        prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "",
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to all the *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to all the
+                *path operations* in this router.
+
+                Read more about it in the
+                [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                The default response class to be used.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+                """
+            ),
+        ] = Default(JSONResponse),
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                OpenAPI callbacks that should apply to all *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        routes: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                **Note**: you probably shouldn't use this parameter, it is inherited
+                from Starlette and supported for compatibility.
+
+                ---
+
+                A list of routes to serve incoming HTTP and WebSocket requests.
+                """
+            ),
+            deprecated(
+                """
+                You normally wouldn't use this parameter with FastAPI, it is inherited
+                from Starlette and supported for compatibility.
+
+                In FastAPI, you normally would use the *path operation methods*,
+                like `router.get()`, `router.post()`, etc.
+                """
+            ),
+        ] = None,
+        redirect_slashes: Annotated[
+            bool,
+            Doc(
+                """
+                Whether to detect and redirect slashes in URLs when the client doesn't
+                use the same format.
+                """
+            ),
+        ] = True,
+        default: Annotated[
+            Optional[ASGIApp],
+            Doc(
+                """
+                Default function handler for this router. Used to handle
+                404 Not Found errors.
+                """
+            ),
+        ] = None,
+        dependency_overrides_provider: Annotated[
+            Optional[Any],
+            Doc(
+                """
+                Only used internally by FastAPI to handle dependency overrides.
+
+                You shouldn't need to use it. It normally points to the `FastAPI` app
+                object.
+                """
+            ),
+        ] = None,
+        route_class: Annotated[
+            Type[APIRoute],
+            Doc(
+                """
+                Custom route (*path operation*) class to be used by this router.
+
+                Read more about it in the
+                [FastAPI docs for Custom Request and APIRoute class](https://fastapi.tiangolo.com/how-to/custom-request-and-route/#custom-apiroute-class-in-a-router).
+                """
+            ),
+        ] = APIRoute,
+        on_startup: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of startup event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        on_shutdown: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of shutdown event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
         # the generic to Lifespan[AppType] is the type of the top level application
         # which the router cannot know statically, so we use typing.Any
-        lifespan: Optional[Lifespan[Any]] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        lifespan: Annotated[
+            Optional[Lifespan[Any]],
+            Doc(
+                """
+                A `Lifespan` context manager handler. This replaces `startup` and
+                `shutdown` functions with a single context manager.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all *path operations* in this router as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                To include (or not) all the *path operations* in this router in the
+                generated OpenAPI.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> None:
         super().__init__(
             routes=routes,
@@ -771,11 +986,63 @@ class APIRouter(routing.Router):
 
     def websocket(
         self,
-        path: str,
-        name: Optional[str] = None,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                WebSocket path.
+                """
+            ),
+        ],
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A name for the WebSocket. Only used internally.
+                """
+            ),
+        ] = None,
         *,
-        dependencies: Optional[Sequence[params.Depends]] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be used for this
+                WebSocket.
+
+                Read more about it in the
+                [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+                """
+            ),
+        ] = None,
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Decorate a WebSocket function.
+
+        Read more about it in the
+        [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+
+        **Example**
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI, WebSocket
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.websocket("/ws")
+        async def websocket_endpoint(websocket: WebSocket):
+            await websocket.accept()
+            while True:
+                data = await websocket.receive_text()
+                await websocket.send_text(f"Message text was: {data}")
+
+        app.include_router(router)
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_api_websocket_route(
                 path, func, name=name, dependencies=dependencies
@@ -795,20 +1062,139 @@ class APIRouter(routing.Router):
 
     def include_router(
         self,
-        router: "APIRouter",
+        router: Annotated["APIRouter", Doc("The `APIRouter` to include.")],
         *,
-        prefix: str = "",
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "",
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to all the *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to all the
+                *path operations* in this router.
+
+                Read more about it in the
+                [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                The default response class to be used.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+                """
+            ),
+        ] = Default(JSONResponse),
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                OpenAPI callbacks that should apply to all *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all *path operations* in this router as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include (or not) all the *path operations* in this router in the
+                generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = True,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> None:
+        """
+        Include another `APIRouter` in the same current `APIRouter`.
+
+        Read more about it in the
+        [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/).
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        internal_router = APIRouter()
+        users_router = APIRouter()
+
+        @users_router.get("/users/")
+        def read_users():
+            return [{"name": "Rick"}, {"name": "Morty"}]
+
+        internal_router.include_router(users_router)
+        app.include_router(internal_router)
+        ```
+        """
         if prefix:
             assert prefix.startswith("/"), "A path prefix must start with '/'"
             assert not prefix.endswith(
@@ -920,33 +1306,354 @@ class APIRouter(routing.Router):
 
     def get(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP GET operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.get("/items/")
+        def read_items():
+            return [{"name": "Empanada"}, {"name": "Arepa"}]
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -976,33 +1683,359 @@ class APIRouter(routing.Router):
 
     def put(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PUT operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.put("/items/{item_id}")
+        def replace_item(item_id: str, item: Item):
+            return {"message": "Item replaced", "id": item_id}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1032,33 +2065,359 @@ class APIRouter(routing.Router):
 
     def post(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP POST operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.post("/items/")
+        def create_item(item: Item):
+            return {"message": "Item created"}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1088,33 +2447,354 @@ class APIRouter(routing.Router):
 
     def delete(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP DELETE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.delete("/items/{item_id}")
+        def delete_item(item_id: str):
+            return {"message": "Item deleted"}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1144,33 +2824,354 @@ class APIRouter(routing.Router):
 
     def options(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP OPTIONS operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.options("/items/")
+        def get_item_options():
+            return {"additions": ["Aji", "Guacamole"]}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1200,33 +3201,359 @@ class APIRouter(routing.Router):
 
     def head(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP HEAD operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.head("/items/", status_code=204)
+        def get_items_headers(response: Response):
+            response.headers["X-Cat-Dog"] = "Alone in the world"
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1256,33 +3583,359 @@ class APIRouter(routing.Router):
 
     def patch(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PATCH operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.patch("/items/")
+        def update_item(item: Item):
+            return {"message": "Item updated in place"}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1312,33 +3965,359 @@ class APIRouter(routing.Router):
 
     def trace(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP TRACE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.put("/items/{item_id}")
+        def trace_item(item_id: str):
+            return None
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1366,9 +4345,34 @@ class APIRouter(routing.Router):
             generate_unique_id_function=generate_unique_id_function,
         )
 
+    @deprecated(
+        """
+        on_event is deprecated, use lifespan event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/).
+        """
+    )
     def on_event(
-        self, event_type: str
+        self,
+        event_type: Annotated[
+            str,
+            Doc(
+                """
+                The type of event. `startup` or `shutdown`.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add an event handler for the router.
+
+        `on_event` is deprecated, use `lifespan` event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/#alternative-events-deprecated).
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_event_handler(event_type, func)
             return func
diff --git a/fastapi/security/api_key.py b/fastapi/security/api_key.py
index 8b2c5c080..b1a6b4f94 100644
--- a/fastapi/security/api_key.py
+++ b/fastapi/security/api_key.py
@@ -5,6 +5,7 @@ from fastapi.security.base import SecurityBase
 from starlette.exceptions import HTTPException
 from starlette.requests import Request
 from starlette.status import HTTP_403_FORBIDDEN
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class APIKeyBase(SecurityBase):
@@ -12,13 +13,83 @@ class APIKeyBase(SecurityBase):
 
 
 class APIKeyQuery(APIKeyBase):
+    """
+    API key authentication using a query parameter.
+
+    This defines the name of the query parameter that should be provided in the request
+    with the API key and integrates that into the OpenAPI documentation. It extracts
+    the key value sent in the query parameter automatically and provides it as the
+    dependency result. But it doesn't define how to send that API key to the client.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be a string containing the key value.
+
+    ## Example
+
+    ```python
+    from fastapi import Depends, FastAPI
+    from fastapi.security import APIKeyQuery
+
+    app = FastAPI()
+
+    query_scheme = APIKeyQuery(name="api_key")
+
+
+    @app.get("/items/")
+    async def read_items(api_key: str = Depends(query_scheme)):
+        return {"api_key": api_key}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        name: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        name: Annotated[
+            str,
+            Doc("Query parameter name."),
+        ],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the query parameter is not provided, `APIKeyQuery` will
+                automatically cancel the request and sebd the client an error.
+
+                If `auto_error` is set to `False`, when the query parameter is not
+                available, instead of erroring out, the dependency result will be
+                `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in a query
+                parameter or in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model: APIKey = APIKey(
             **{"in": APIKeyIn.query},  # type: ignore[arg-type]
@@ -41,13 +112,79 @@ class APIKeyQuery(APIKeyBase):
 
 
 class APIKeyHeader(APIKeyBase):
+    """
+    API key authentication using a header.
+
+    This defines the name of the header that should be provided in the request with
+    the API key and integrates that into the OpenAPI documentation. It extracts
+    the key value sent in the header automatically and provides it as the dependency
+    result. But it doesn't define how to send that key to the client.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be a string containing the key value.
+
+    ## Example
+
+    ```python
+    from fastapi import Depends, FastAPI
+    from fastapi.security import APIKeyHeader
+
+    app = FastAPI()
+
+    header_scheme = APIKeyHeader(name="x-key")
+
+
+    @app.get("/items/")
+    async def read_items(key: str = Depends(header_scheme)):
+        return {"key": key}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        name: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        name: Annotated[str, Doc("Header name.")],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the header is not provided, `APIKeyHeader` will
+                automatically cancel the request and send the client an error.
+
+                If `auto_error` is set to `False`, when the header is not available,
+                instead of erroring out, the dependency result will be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in a header or
+                in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model: APIKey = APIKey(
             **{"in": APIKeyIn.header},  # type: ignore[arg-type]
@@ -70,13 +207,79 @@ class APIKeyHeader(APIKeyBase):
 
 
 class APIKeyCookie(APIKeyBase):
+    """
+    API key authentication using a cookie.
+
+    This defines the name of the cookie that should be provided in the request with
+    the API key and integrates that into the OpenAPI documentation. It extracts
+    the key value sent in the cookie automatically and provides it as the dependency
+    result. But it doesn't define how to set that cookie.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be a string containing the key value.
+
+    ## Example
+
+    ```python
+    from fastapi import Depends, FastAPI
+    from fastapi.security import APIKeyCookie
+
+    app = FastAPI()
+
+    cookie_scheme = APIKeyCookie(name="session")
+
+
+    @app.get("/items/")
+    async def read_items(session: str = Depends(cookie_scheme)):
+        return {"session": session}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        name: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        name: Annotated[str, Doc("Cookie name.")],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the cookie is not provided, `APIKeyCookie` will
+                automatically cancel the request and send the client an error.
+
+                If `auto_error` is set to `False`, when the cookie is not available,
+                instead of erroring out, the dependency result will be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in a cookie or
+                in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model: APIKey = APIKey(
             **{"in": APIKeyIn.cookie},  # type: ignore[arg-type]
diff --git a/fastapi/security/http.py b/fastapi/security/http.py
index 8fc0aafd9..738455de3 100644
--- a/fastapi/security/http.py
+++ b/fastapi/security/http.py
@@ -10,16 +10,60 @@ from fastapi.security.utils import get_authorization_scheme_param
 from pydantic import BaseModel
 from starlette.requests import Request
 from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class HTTPBasicCredentials(BaseModel):
-    username: str
-    password: str
+    """
+    The HTTP Basic credendials given as the result of using `HTTPBasic` in a
+    dependency.
+
+    Read more about it in the
+    [FastAPI docs for HTTP Basic Auth](https://fastapi.tiangolo.com/advanced/security/http-basic-auth/).
+    """
+
+    username: Annotated[str, Doc("The HTTP Basic username.")]
+    password: Annotated[str, Doc("The HTTP Basic password.")]
 
 
 class HTTPAuthorizationCredentials(BaseModel):
-    scheme: str
-    credentials: str
+    """
+    The HTTP authorization credentials in the result of using `HTTPBearer` or
+    `HTTPDigest` in a dependency.
+
+    The HTTP authorization header value is split by the first space.
+
+    The first part is the `scheme`, the second part is the `credentials`.
+
+    For example, in an HTTP Bearer token scheme, the client will send a header
+    like:
+
+    ```
+    Authorization: Bearer deadbeef12346
+    ```
+
+    In this case:
+
+    * `scheme` will have the value `"Bearer"`
+    * `credentials` will have the value `"deadbeef12346"`
+    """
+
+    scheme: Annotated[
+        str,
+        Doc(
+            """
+            The HTTP authorization scheme extracted from the header value.
+            """
+        ),
+    ]
+    credentials: Annotated[
+        str,
+        Doc(
+            """
+            The HTTP authorization credentials extracted from the header value.
+            """
+        ),
+    ]
 
 
 class HTTPBase(SecurityBase):
@@ -51,13 +95,89 @@ class HTTPBase(SecurityBase):
 
 
 class HTTPBasic(HTTPBase):
+    """
+    HTTP Basic authentication.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be an `HTTPBasicCredentials` object containing the
+    `username` and the `password`.
+
+    Read more about it in the
+    [FastAPI docs for HTTP Basic Auth](https://fastapi.tiangolo.com/advanced/security/http-basic-auth/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import HTTPBasic, HTTPBasicCredentials
+
+    app = FastAPI()
+
+    security = HTTPBasic()
+
+
+    @app.get("/users/me")
+    def read_current_user(credentials: Annotated[HTTPBasicCredentials, Depends(security)]):
+        return {"username": credentials.username, "password": credentials.password}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        scheme_name: Optional[str] = None,
-        realm: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        realm: Annotated[
+            Optional[str],
+            Doc(
+                """
+                HTTP Basic authentication realm.
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the HTTP Basic authentication is not provided (a
+                header), `HTTPBasic` will automatically cancel the request and send the
+                client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Basic authentication
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in HTTP Basic
+                authentication or in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model = HTTPBaseModel(scheme="basic", description=description)
         self.scheme_name = scheme_name or self.__class__.__name__
@@ -90,7 +210,7 @@ class HTTPBasic(HTTPBase):
         try:
             data = b64decode(param).decode("ascii")
         except (ValueError, UnicodeDecodeError, binascii.Error):
-            raise invalid_user_credentials_exc
+            raise invalid_user_credentials_exc  # noqa: B904
         username, separator, password = data.partition(":")
         if not separator:
             raise invalid_user_credentials_exc
@@ -98,13 +218,81 @@ class HTTPBasic(HTTPBase):
 
 
 class HTTPBearer(HTTPBase):
+    """
+    HTTP Bearer token authentication.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be an `HTTPAuthorizationCredentials` object containing
+    the `scheme` and the `credentials`.
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
+
+    app = FastAPI()
+
+    security = HTTPBearer()
+
+
+    @app.get("/users/me")
+    def read_current_user(
+        credentials: Annotated[HTTPAuthorizationCredentials, Depends(security)]
+    ):
+        return {"scheme": credentials.scheme, "credentials": credentials.credentials}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        bearerFormat: Optional[str] = None,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        bearerFormat: Annotated[Optional[str], Doc("Bearer token format.")] = None,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the HTTP Bearer token not provided (in an
+                `Authorization` header), `HTTPBearer` will automatically cancel the
+                request and send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Bearer token
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in an HTTP
+                Bearer token or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = HTTPBearerModel(bearerFormat=bearerFormat, description=description)
         self.scheme_name = scheme_name or self.__class__.__name__
@@ -134,12 +322,79 @@ class HTTPBearer(HTTPBase):
 
 
 class HTTPDigest(HTTPBase):
+    """
+    HTTP Digest authentication.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be an `HTTPAuthorizationCredentials` object containing
+    the `scheme` and the `credentials`.
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import HTTPAuthorizationCredentials, HTTPDigest
+
+    app = FastAPI()
+
+    security = HTTPDigest()
+
+
+    @app.get("/users/me")
+    def read_current_user(
+        credentials: Annotated[HTTPAuthorizationCredentials, Depends(security)]
+    ):
+        return {"scheme": credentials.scheme, "credentials": credentials.credentials}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the HTTP Digest not provided, `HTTPDigest` will
+                automatically cancel the request and send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Digest is not
+                available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in HTTP
+                Digest or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = HTTPBaseModel(scheme="digest", description=description)
         self.scheme_name = scheme_name or self.__class__.__name__
diff --git a/fastapi/security/oauth2.py b/fastapi/security/oauth2.py
index e4c4357e7..9281dfb64 100644
--- a/fastapi/security/oauth2.py
+++ b/fastapi/security/oauth2.py
@@ -10,51 +10,136 @@ from starlette.requests import Request
 from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN
 
 # TODO: import from typing when deprecating Python 3.9
-from typing_extensions import Annotated
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class OAuth2PasswordRequestForm:
     """
-    This is a dependency class, use it like:
+    This is a dependency class to collect the `username` and `password` as form data
+    for an OAuth2 password flow.
 
-        @app.post("/login")
-        def login(form_data: OAuth2PasswordRequestForm = Depends()):
-            data = form_data.parse()
-            print(data.username)
-            print(data.password)
-            for scope in data.scopes:
-                print(scope)
-            if data.client_id:
-                print(data.client_id)
-            if data.client_secret:
-                print(data.client_secret)
-            return data
+    The OAuth2 specification dictates that for a password flow the data should be
+    collected using form data (instead of JSON) and that it should have the specific
+    fields `username` and `password`.
+
+    All the initialization parameters are extracted from the request.
+
+    Read more about it in the
+    [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import OAuth2PasswordRequestForm
+
+    app = FastAPI()
 
 
-    It creates the following Form request parameters in your endpoint:
+    @app.post("/login")
+    def login(form_data: Annotated[OAuth2PasswordRequestForm, Depends()]):
+        data = {}
+        data["scopes"] = []
+        for scope in form_data.scopes:
+            data["scopes"].append(scope)
+        if form_data.client_id:
+            data["client_id"] = form_data.client_id
+        if form_data.client_secret:
+            data["client_secret"] = form_data.client_secret
+        return data
+    ```
 
-    grant_type: the OAuth2 spec says it is required and MUST be the fixed string "password".
-        Nevertheless, this dependency class is permissive and allows not passing it. If you want to enforce it,
-        use instead the OAuth2PasswordRequestFormStrict dependency.
-    username: username string. The OAuth2 spec requires the exact field name "username".
-    password: password string. The OAuth2 spec requires the exact field name "password".
-    scope: Optional string. Several scopes (each one a string) separated by spaces. E.g.
-        "items:read items:write users:read profile openid"
-    client_id: optional string. OAuth2 recommends sending the client_id and client_secret (if any)
-        using HTTP Basic auth, as: client_id:client_secret
-    client_secret: optional string. OAuth2 recommends sending the client_id and client_secret (if any)
-        using HTTP Basic auth, as: client_id:client_secret
+    Note that for OAuth2 the scope `items:read` is a single scope in an opaque string.
+    You could have custom internal logic to separate it by colon caracters (`:`) or
+    similar, and get the two parts `items` and `read`. Many applications do that to
+    group and organize permisions, you could do it as well in your application, just
+    know that that it is application specific, it's not part of the specification.
     """
 
     def __init__(
         self,
         *,
-        grant_type: Annotated[Union[str, None], Form(pattern="password")] = None,
-        username: Annotated[str, Form()],
-        password: Annotated[str, Form()],
-        scope: Annotated[str, Form()] = "",
-        client_id: Annotated[Union[str, None], Form()] = None,
-        client_secret: Annotated[Union[str, None], Form()] = None,
+        grant_type: Annotated[
+            Union[str, None],
+            Form(pattern="password"),
+            Doc(
+                """
+                The OAuth2 spec says it is required and MUST be the fixed string
+                "password". Nevertheless, this dependency class is permissive and
+                allows not passing it. If you want to enforce it, use instead the
+                `OAuth2PasswordRequestFormStrict` dependency.
+                """
+            ),
+        ] = None,
+        username: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `username` string. The OAuth2 spec requires the exact field name
+                `username`.
+                """
+            ),
+        ],
+        password: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `password` string. The OAuth2 spec requires the exact field name
+                `password".
+                """
+            ),
+        ],
+        scope: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                A single string with actually several scopes separated by spaces. Each
+                scope is also a string.
+
+                For example, a single string with:
+
+                ```python
+                "items:read items:write users:read profile openid"
+                ````
+
+                would represent the scopes:
+
+                * `items:read`
+                * `items:write`
+                * `users:read`
+                * `profile`
+                * `openid`
+                """
+            ),
+        ] = "",
+        client_id: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_id`, it can be sent as part of the form fields.
+                But the OAuth2 specification recommends sending the `client_id` and
+                `client_secret` (if any) using HTTP Basic auth.
+                """
+            ),
+        ] = None,
+        client_secret: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_password` (and a `client_id`), they can be sent
+                as part of the form fields. But the OAuth2 specification recommends
+                sending the `client_id` and `client_secret` (if any) using HTTP Basic
+                auth.
+                """
+            ),
+        ] = None,
     ):
         self.grant_type = grant_type
         self.username = username
@@ -66,23 +151,54 @@ class OAuth2PasswordRequestForm:
 
 class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
     """
-    This is a dependency class, use it like:
+    This is a dependency class to collect the `username` and `password` as form data
+    for an OAuth2 password flow.
 
-        @app.post("/login")
-        def login(form_data: OAuth2PasswordRequestFormStrict = Depends()):
-            data = form_data.parse()
-            print(data.username)
-            print(data.password)
-            for scope in data.scopes:
-                print(scope)
-            if data.client_id:
-                print(data.client_id)
-            if data.client_secret:
-                print(data.client_secret)
-            return data
+    The OAuth2 specification dictates that for a password flow the data should be
+    collected using form data (instead of JSON) and that it should have the specific
+    fields `username` and `password`.
+
+    All the initialization parameters are extracted from the request.
+
+    The only difference between `OAuth2PasswordRequestFormStrict` and
+    `OAuth2PasswordRequestForm` is that `OAuth2PasswordRequestFormStrict` requires the
+    client to send the form field `grant_type` with the value `"password"`, which
+    is required in the OAuth2 specification (it seems that for no particular reason),
+    while for `OAuth2PasswordRequestForm` `grant_type` is optional.
+
+    Read more about it in the
+    [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import OAuth2PasswordRequestForm
+
+    app = FastAPI()
 
 
-    It creates the following Form request parameters in your endpoint:
+    @app.post("/login")
+    def login(form_data: Annotated[OAuth2PasswordRequestFormStrict, Depends()]):
+        data = {}
+        data["scopes"] = []
+        for scope in form_data.scopes:
+            data["scopes"].append(scope)
+        if form_data.client_id:
+            data["client_id"] = form_data.client_id
+        if form_data.client_secret:
+            data["client_secret"] = form_data.client_secret
+        return data
+    ```
+
+    Note that for OAuth2 the scope `items:read` is a single scope in an opaque string.
+    You could have custom internal logic to separate it by colon caracters (`:`) or
+    similar, and get the two parts `items` and `read`. Many applications do that to
+    group and organize permisions, you could do it as well in your application, just
+    know that that it is application specific, it's not part of the specification.
+
 
     grant_type: the OAuth2 spec says it is required and MUST be the fixed string "password".
         This dependency is strict about it. If you want to be permissive, use instead the
@@ -99,12 +215,85 @@ class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
 
     def __init__(
         self,
-        grant_type: Annotated[str, Form(pattern="password")],
-        username: Annotated[str, Form()],
-        password: Annotated[str, Form()],
-        scope: Annotated[str, Form()] = "",
-        client_id: Annotated[Union[str, None], Form()] = None,
-        client_secret: Annotated[Union[str, None], Form()] = None,
+        grant_type: Annotated[
+            str,
+            Form(pattern="password"),
+            Doc(
+                """
+                The OAuth2 spec says it is required and MUST be the fixed string
+                "password". This dependency is strict about it. If you want to be
+                permissive, use instead the `OAuth2PasswordRequestForm` dependency
+                class.
+                """
+            ),
+        ],
+        username: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `username` string. The OAuth2 spec requires the exact field name
+                `username`.
+                """
+            ),
+        ],
+        password: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `password` string. The OAuth2 spec requires the exact field name
+                `password".
+                """
+            ),
+        ],
+        scope: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                A single string with actually several scopes separated by spaces. Each
+                scope is also a string.
+
+                For example, a single string with:
+
+                ```python
+                "items:read items:write users:read profile openid"
+                ````
+
+                would represent the scopes:
+
+                * `items:read`
+                * `items:write`
+                * `users:read`
+                * `profile`
+                * `openid`
+                """
+            ),
+        ] = "",
+        client_id: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_id`, it can be sent as part of the form fields.
+                But the OAuth2 specification recommends sending the `client_id` and
+                `client_secret` (if any) using HTTP Basic auth.
+                """
+            ),
+        ] = None,
+        client_secret: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_password` (and a `client_id`), they can be sent
+                as part of the form fields. But the OAuth2 specification recommends
+                sending the `client_id` and `client_secret` (if any) using HTTP Basic
+                auth.
+                """
+            ),
+        ] = None,
     ):
         super().__init__(
             grant_type=grant_type,
@@ -117,13 +306,69 @@ class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
 
 
 class OAuth2(SecurityBase):
+    """
+    This is the base class for OAuth2 authentication, an instance of it would be used
+    as a dependency. All other OAuth2 classes inherit from it and customize it for
+    each OAuth2 flow.
+
+    You normally would not create a new class inheriting from it but use one of the
+    existing subclasses, and maybe compose them if you want to support multiple flows.
+
+    Read more about it in the
+    [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/).
+    """
+
     def __init__(
         self,
         *,
-        flows: Union[OAuthFlowsModel, Dict[str, Dict[str, Any]]] = OAuthFlowsModel(),
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        flows: Annotated[
+            Union[OAuthFlowsModel, Dict[str, Dict[str, Any]]],
+            Doc(
+                """
+                The dictionary of OAuth2 flows.
+                """
+            ),
+        ] = OAuthFlowsModel(),
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OAuth2 authentication, it will automatically cancel the request and
+                send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OAuth2
+                or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = OAuth2Model(
             flows=cast(OAuthFlowsModel, flows), description=description
@@ -144,13 +389,74 @@ class OAuth2(SecurityBase):
 
 
 class OAuth2PasswordBearer(OAuth2):
+    """
+    OAuth2 flow for authentication using a bearer token obtained with a password.
+    An instance of it would be used as a dependency.
+
+    Read more about it in the
+    [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/).
+    """
+
     def __init__(
         self,
-        tokenUrl: str,
-        scheme_name: Optional[str] = None,
-        scopes: Optional[Dict[str, str]] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        tokenUrl: Annotated[
+            str,
+            Doc(
+                """
+                The URL to obtain the OAuth2 token. This would be the *path operation*
+                that has `OAuth2PasswordRequestForm` as a dependency.
+                """
+            ),
+        ],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        scopes: Annotated[
+            Optional[Dict[str, str]],
+            Doc(
+                """
+                The OAuth2 scopes that would be required by the *path operations* that
+                use this dependency.
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OAuth2 authentication, it will automatically cancel the request and
+                send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OAuth2
+                or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         if not scopes:
             scopes = {}
@@ -180,15 +486,79 @@ class OAuth2PasswordBearer(OAuth2):
 
 
 class OAuth2AuthorizationCodeBearer(OAuth2):
+    """
+    OAuth2 flow for authentication using a bearer token obtained with an OAuth2 code
+    flow. An instance of it would be used as a dependency.
+    """
+
     def __init__(
         self,
         authorizationUrl: str,
-        tokenUrl: str,
-        refreshUrl: Optional[str] = None,
-        scheme_name: Optional[str] = None,
-        scopes: Optional[Dict[str, str]] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        tokenUrl: Annotated[
+            str,
+            Doc(
+                """
+                The URL to obtain the OAuth2 token.
+                """
+            ),
+        ],
+        refreshUrl: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The URL to refresh the token and obtain a new one.
+                """
+            ),
+        ] = None,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        scopes: Annotated[
+            Optional[Dict[str, str]],
+            Doc(
+                """
+                The OAuth2 scopes that would be required by the *path operations* that
+                use this dependency.
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OAuth2 authentication, it will automatically cancel the request and
+                send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OAuth2
+                or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         if not scopes:
             scopes = {}
@@ -226,6 +596,43 @@ class OAuth2AuthorizationCodeBearer(OAuth2):
 
 
 class SecurityScopes:
-    def __init__(self, scopes: Optional[List[str]] = None):
-        self.scopes = scopes or []
-        self.scope_str = " ".join(self.scopes)
+    """
+    This is a special class that you can define in a parameter in a dependency to
+    obtain the OAuth2 scopes required by all the dependencies in the same chain.
+
+    This way, multiple dependencies can have different scopes, even when used in the
+    same *path operation*. And with this, you can access all the scopes required in
+    all those dependencies in a single place.
+
+    Read more about it in the
+    [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/).
+    """
+
+    def __init__(
+        self,
+        scopes: Annotated[
+            Optional[List[str]],
+            Doc(
+                """
+                This will be filled by FastAPI.
+                """
+            ),
+        ] = None,
+    ):
+        self.scopes: Annotated[
+            List[str],
+            Doc(
+                """
+                The list of all the scopes required by dependencies.
+                """
+            ),
+        ] = scopes or []
+        self.scope_str: Annotated[
+            str,
+            Doc(
+                """
+                All the scopes required by all the dependencies in a single string
+                separated by spaces, as defined in the OAuth2 specification.
+                """
+            ),
+        ] = " ".join(self.scopes)
diff --git a/fastapi/security/open_id_connect_url.py b/fastapi/security/open_id_connect_url.py
index 4e65f1f6c..c612b475d 100644
--- a/fastapi/security/open_id_connect_url.py
+++ b/fastapi/security/open_id_connect_url.py
@@ -5,16 +5,66 @@ from fastapi.security.base import SecurityBase
 from starlette.exceptions import HTTPException
 from starlette.requests import Request
 from starlette.status import HTTP_403_FORBIDDEN
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class OpenIdConnect(SecurityBase):
+    """
+    OpenID Connect authentication class. An instance of it would be used as a
+    dependency.
+    """
+
     def __init__(
         self,
         *,
-        openIdConnectUrl: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        openIdConnectUrl: Annotated[
+            str,
+            Doc(
+                """
+            The OpenID Connect URL.
+            """
+            ),
+        ],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OpenID Connect authentication, it will automatically cancel the request
+                and send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OpenID
+                Connect or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = OpenIdConnectModel(
             openIdConnectUrl=openIdConnectUrl, description=description
diff --git a/fastapi/utils.py b/fastapi/utils.py
index 267d64ce8..f8463dda2 100644
--- a/fastapi/utils.py
+++ b/fastapi/utils.py
@@ -117,7 +117,7 @@ def create_cloned_field(
     if PYDANTIC_V2:
         return field
     # cloned_types caches already cloned types to support recursive models and improve
-    # performance by avoiding unecessary cloning
+    # performance by avoiding unnecessary cloning
     if cloned_types is None:
         cloned_types = _CLONED_TYPES_CACHE
 
@@ -152,7 +152,8 @@ def create_cloned_field(
         ]
     if field.key_field:  # type: ignore[attr-defined]
         new_field.key_field = create_cloned_field(  # type: ignore[attr-defined]
-            field.key_field, cloned_types=cloned_types  # type: ignore[attr-defined]
+            field.key_field,  # type: ignore[attr-defined]
+            cloned_types=cloned_types,
         )
     new_field.validators = field.validators  # type: ignore[attr-defined]
     new_field.pre_validators = field.pre_validators  # type: ignore[attr-defined]
diff --git a/pyproject.toml b/pyproject.toml
index f0917578f..e67486ae3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 name = "fastapi"
 description = "FastAPI framework, high performance, easy to learn, fast to code, ready for production"
 readme = "README.md"
-requires-python = ">=3.7"
+requires-python = ">=3.8"
 license = "MIT"
 authors = [
     { name = "Sebastián Ramírez", email = "tiangolo@gmail.com" },
@@ -32,7 +32,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.7",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
@@ -42,8 +41,10 @@ classifiers = [
 ]
 dependencies = [
     "starlette>=0.27.0,<0.28.0",
-    "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,<3.0.0",
-    "typing-extensions>=4.5.0",
+    "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
+    "typing-extensions>=4.8.0",
+    # TODO: remove this pin after upgrading Starlette 0.31.1
+    "anyio>=3.7.1,<4.0.0",
 ]
 dynamic = ["version"]
 
@@ -129,11 +130,13 @@ select = [
     "I",  # isort
     "C",  # flake8-comprehensions
     "B",  # flake8-bugbear
+    "UP",  # pyupgrade
 ]
 ignore = [
     "E501",  # line too long, handled by black
     "B008",  # do not perform function calls in argument defaults
     "C901",  # too complex
+    "W191", # indentation contains tabs
 ]
 
 [tool.ruff.per-file-ignores]
@@ -153,6 +156,22 @@ ignore = [
 "docs_src/query_params_str_validations/tutorial012_an_py39.py" = ["B006"]
 "docs_src/query_params_str_validations/tutorial013_an.py" = ["B006"]
 "docs_src/query_params_str_validations/tutorial013_an_py39.py" = ["B006"]
+"docs_src/security/tutorial004.py" = ["B904"]
+"docs_src/security/tutorial004_an.py" = ["B904"]
+"docs_src/security/tutorial004_an_py310.py" = ["B904"]
+"docs_src/security/tutorial004_an_py39.py" = ["B904"]
+"docs_src/security/tutorial004_py310.py" = ["B904"]
+"docs_src/security/tutorial005.py" = ["B904"]
+"docs_src/security/tutorial005_an.py" = ["B904"]
+"docs_src/security/tutorial005_an_py310.py" = ["B904"]
+"docs_src/security/tutorial005_an_py39.py" = ["B904"]
+"docs_src/security/tutorial005_py310.py" = ["B904"]
+"docs_src/security/tutorial005_py39.py" = ["B904"]
+
 
 [tool.ruff.isort]
 known-third-party = ["fastapi", "pydantic", "starlette"]
+
+[tool.ruff.pyupgrade]
+# Preserve types, even if a file imports `from __future__ import annotations`.
+keep-runtime-typing = true
diff --git a/requirements-docs-tests.txt b/requirements-docs-tests.txt
new file mode 100644
index 000000000..b82df4933
--- /dev/null
+++ b/requirements-docs-tests.txt
@@ -0,0 +1,2 @@
+# For mkdocstrings and tests
+httpx >=0.23.0,<0.25.0
diff --git a/requirements-docs.txt b/requirements-docs.txt
index df60ca4df..28408a9f1 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,14 +1,19 @@
 -e .
-mkdocs==1.4.3
-mkdocs-material==9.1.17
+-r requirements-docs-tests.txt
+mkdocs-material==9.4.7
 mdx-include >=1.4.1,<2.0.0
 mkdocs-markdownextradata-plugin >=0.1.7,<0.3.0
+mkdocs-redirects>=1.2.1,<1.3.0
 typer-cli >=0.0.13,<0.0.14
 typer[all] >=0.6.1,<0.8.0
 pyyaml >=5.3.1,<7.0.0
 # For Material for MkDocs, Chinese search
 jieba==0.42.1
 # For image processing by Material for MkDocs
-pillow==9.5.0
+pillow==10.1.0
 # For image processing by Material for MkDocs
 cairosvg==2.7.0
+mkdocstrings[python]==0.23.0
+griffe-typingdoc==0.2.2
+# For griffe, it formats with black
+black==23.3.0
diff --git a/requirements-tests.txt b/requirements-tests.txt
index abefac685..e1a976c13 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -1,17 +1,15 @@
 -e .
+-r requirements-docs-tests.txt
 pydantic-settings >=2.0.0
 pytest >=7.1.3,<8.0.0
 coverage[toml] >= 6.5.0,< 8.0
-mypy ==1.4.0
-ruff ==0.0.275
-black == 23.3.0
-httpx >=0.23.0,<0.25.0
+mypy ==1.4.1
+ruff ==0.1.2
 email_validator >=1.1.1,<3.0.0
 dirty-equals ==0.6.0
 # TODO: once removing databases from tutorial, upgrade SQLAlchemy
 # probably when including SQLModel
 sqlalchemy >=1.3.18,<1.4.43
-peewee >=3.13.3,<4.0.0
 databases[sqlite] >=0.3.2,<0.7.0
 orjson >=3.2.1,<4.0.0
 ujson >=4.0.1,!=4.0.2,!=4.1.0,!=4.2.0,!=4.3.0,!=5.0.0,!=5.1.0,<6.0.0
diff --git a/requirements.txt b/requirements.txt
index 7e746016a..ef25ec483 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,3 +3,5 @@
 -r requirements-docs.txt
 uvicorn[standard] >=0.12.0,<0.23.0
 pre-commit >=2.17.0,<4.0.0
+# For generating screenshots
+playwright
diff --git a/scripts/docs.py b/scripts/docs.py
index 968dd9a3d..73e1900ad 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -36,7 +36,7 @@ site_path = Path("site").absolute()
 build_site_path = Path("site_build").absolute()
 
 
-@lru_cache()
+@lru_cache
 def is_mkdocs_insiders() -> bool:
     version = metadata.version("mkdocs-material")
     return "insiders" in version
@@ -104,7 +104,7 @@ def new_lang(lang: str = typer.Argument(..., callback=lang_callback)):
 def build_lang(
     lang: str = typer.Argument(
         ..., callback=lang_callback, autocompletion=complete_existing_lang
-    )
+    ),
 ) -> None:
     """
     Build the docs for a language.
@@ -153,17 +153,21 @@ index_sponsors_template = """
 def generate_readme_content() -> str:
     en_index = en_docs_path / "docs" / "index.md"
     content = en_index.read_text("utf-8")
+    match_pre = re.search(r"</style>\n\n", content)
     match_start = re.search(r"<!-- sponsors -->", content)
     match_end = re.search(r"<!-- /sponsors -->", content)
     sponsors_data_path = en_docs_path / "data" / "sponsors.yml"
     sponsors = mkdocs.utils.yaml_load(sponsors_data_path.read_text(encoding="utf-8"))
     if not (match_start and match_end):
         raise RuntimeError("Couldn't auto-generate sponsors section")
+    if not match_pre:
+        raise RuntimeError("Couldn't find pre section (<style>) in index.md")
+    frontmatter_end = match_pre.end()
     pre_end = match_start.end()
     post_start = match_end.start()
     template = Template(index_sponsors_template)
     message = template.render(sponsors=sponsors)
-    pre_content = content[:pre_end]
+    pre_content = content[frontmatter_end:pre_end]
     post_content = content[post_start:]
     new_content = pre_content + message + post_content
     return new_content
@@ -247,7 +251,7 @@ def serve() -> None:
 def live(
     lang: str = typer.Argument(
         None, callback=lang_callback, autocompletion=complete_existing_lang
-    )
+    ),
 ) -> None:
     """
     Serve with livereload a docs site for a specific language.
@@ -286,7 +290,6 @@ def update_config() -> None:
         else:
             use_name = alternate_dict[url]
             new_alternate.append({"link": url, "name": use_name})
-    config["nav"][1] = {"Languages": languages}
     config["extra"]["alternate"] = new_alternate
     en_config_path.write_text(
         yaml.dump(config, sort_keys=False, width=200, allow_unicode=True),
diff --git a/scripts/format.sh b/scripts/format.sh
index 3fb3eb4f1..11f25f1ce 100755
--- a/scripts/format.sh
+++ b/scripts/format.sh
@@ -2,4 +2,4 @@
 set -x
 
 ruff fastapi tests docs_src scripts --fix
-black fastapi tests docs_src scripts
+ruff format fastapi tests docs_src scripts
diff --git a/scripts/gitter_releases_bot.py b/scripts/gitter_releases_bot.py
deleted file mode 100644
index a033d0d69..000000000
--- a/scripts/gitter_releases_bot.py
+++ /dev/null
@@ -1,67 +0,0 @@
-import inspect
-import os
-
-import requests
-
-room_id = "5c9c9540d73408ce4fbc1403"  # FastAPI
-# room_id = "5cc46398d73408ce4fbed233"  # Gitter development
-
-gitter_token = os.getenv("GITTER_TOKEN")
-assert gitter_token
-github_token = os.getenv("GITHUB_TOKEN")
-assert github_token
-tag_name = os.getenv("TAG")
-assert tag_name
-
-
-def get_github_graphql(tag_name: str):
-    github_graphql = """
-    {
-    repository(owner: "tiangolo", name: "fastapi") {
-        release (tagName: "{{tag_name}}" ) {
-        description
-        }
-      }
-    }
-    """
-    github_graphql = github_graphql.replace("{{tag_name}}", tag_name)
-    return github_graphql
-
-
-def get_github_release_text(tag_name: str):
-    url = "https://api.github.com/graphql"
-    headers = {"Authorization": f"Bearer {github_token}"}
-    github_graphql = get_github_graphql(tag_name=tag_name)
-    response = requests.post(url, json={"query": github_graphql}, headers=headers)
-    assert response.status_code == 200
-    data = response.json()
-    return data["data"]["repository"]["release"]["description"]
-
-
-def get_gitter_message(release_text: str):
-    text = f"""
-    New release! :tada: :rocket:
-    (by FastAPI bot)
-
-    ## {tag_name}
-    """
-    text = inspect.cleandoc(text) + "\n\n" + release_text
-    return text
-
-
-def send_gitter_message(text: str):
-    headers = {"Authorization": f"Bearer {gitter_token}"}
-    url = f"https://api.gitter.im/v1/rooms/{room_id}/chatMessages"
-    data = {"text": text}
-    response = requests.post(url, headers=headers, json=data)
-    assert response.status_code == 200
-
-
-def main():
-    release_text = get_github_release_text(tag_name=tag_name)
-    text = get_gitter_message(release_text=release_text)
-    send_gitter_message(text=text)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/scripts/lint.sh b/scripts/lint.sh
index 4db5caa96..c0e24db9f 100755
--- a/scripts/lint.sh
+++ b/scripts/lint.sh
@@ -5,4 +5,4 @@ set -x
 
 mypy fastapi
 ruff fastapi tests docs_src scripts
-black fastapi tests --check
+ruff format fastapi tests --check
diff --git a/scripts/mkdocs_hooks.py b/scripts/mkdocs_hooks.py
index 008751f8a..8335a13f6 100644
--- a/scripts/mkdocs_hooks.py
+++ b/scripts/mkdocs_hooks.py
@@ -8,18 +8,23 @@ from mkdocs.structure.files import File, Files
 from mkdocs.structure.nav import Link, Navigation, Section
 from mkdocs.structure.pages import Page
 
+non_traslated_sections = [
+    "reference/",
+    "release-notes.md",
+]
 
-@lru_cache()
+
+@lru_cache
 def get_missing_translation_content(docs_dir: str) -> str:
     docs_dir_path = Path(docs_dir)
     missing_translation_path = docs_dir_path.parent.parent / "missing-translation.md"
     return missing_translation_path.read_text(encoding="utf-8")
 
 
-@lru_cache()
+@lru_cache
 def get_mkdocs_material_langs() -> List[str]:
     material_path = Path(material.__file__).parent
-    material_langs_path = material_path / "partials" / "languages"
+    material_langs_path = material_path / "templates" / "partials" / "languages"
     langs = [file.stem for file in material_langs_path.glob("*.html")]
     return langs
 
@@ -123,6 +128,9 @@ def on_page_markdown(
     markdown: str, *, page: Page, config: MkDocsConfig, files: Files
 ) -> str:
     if isinstance(page.file, EnFile):
+        for excluded_section in non_traslated_sections:
+            if page.file.src_path.startswith(excluded_section):
+                return markdown
         missing_translation_content = get_missing_translation_content(config.docs_dir)
         header = ""
         body = markdown
diff --git a/scripts/notify.sh b/scripts/notify.sh
deleted file mode 100755
index 8ce550026..000000000
--- a/scripts/notify.sh
+++ /dev/null
@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-
-python scripts/gitter_releases_bot.py
diff --git a/scripts/playwright/separate_openapi_schemas/image01.py b/scripts/playwright/separate_openapi_schemas/image01.py
new file mode 100644
index 000000000..0b40f3bbc
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image01.py
@@ -0,0 +1,29 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_text("POST/items/Create Item").click()
+    page.get_by_role("tab", name="Schema").first.click()
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image02.py b/scripts/playwright/separate_openapi_schemas/image02.py
new file mode 100644
index 000000000..f76af7ee2
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image02.py
@@ -0,0 +1,30 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_text("GET/items/Read Items").click()
+    page.get_by_role("button", name="Try it out").click()
+    page.get_by_role("button", name="Execute").click()
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image03.py b/scripts/playwright/separate_openapi_schemas/image03.py
new file mode 100644
index 000000000..127f5c428
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image03.py
@@ -0,0 +1,30 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_text("GET/items/Read Items").click()
+    page.get_by_role("tab", name="Schema").click()
+    page.get_by_label("Schema").get_by_role("button", name="Expand all").click()
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image04.py b/scripts/playwright/separate_openapi_schemas/image04.py
new file mode 100644
index 000000000..208eaf8a0
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image04.py
@@ -0,0 +1,29 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("button", name="Item-Input").click()
+    page.get_by_role("button", name="Item-Output").click()
+    page.set_viewport_size({"width": 960, "height": 820})
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png"
+    )
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image05.py b/scripts/playwright/separate_openapi_schemas/image05.py
new file mode 100644
index 000000000..83966b449
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image05.py
@@ -0,0 +1,29 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("button", name="Item", exact=True).click()
+    page.set_viewport_size({"width": 960, "height": 700})
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial002:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/tests/test_compat.py b/tests/test_compat.py
index 47160ee76..bf268b860 100644
--- a/tests/test_compat.py
+++ b/tests/test_compat.py
@@ -24,7 +24,7 @@ def test_model_field_default_required():
 
 
 @needs_pydanticv1
-def test_upload_file_dummy_general_plain_validator_function():
+def test_upload_file_dummy_with_info_plain_validator_function():
     # For coverage
     assert UploadFile.__get_pydantic_core_schema__(str, lambda x: None) == {}
 
diff --git a/tests/test_computed_fields.py b/tests/test_computed_fields.py
new file mode 100644
index 000000000..5286507b2
--- /dev/null
+++ b/tests/test_computed_fields.py
@@ -0,0 +1,77 @@
+import pytest
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from .utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+    app = FastAPI()
+
+    from pydantic import BaseModel, computed_field
+
+    class Rectangle(BaseModel):
+        width: int
+        length: int
+
+        @computed_field
+        @property
+        def area(self) -> int:
+            return self.width * self.length
+
+    @app.get("/")
+    def read_root() -> Rectangle:
+        return Rectangle(width=3, length=4)
+
+    client = TestClient(app)
+    return client
+
+
+@needs_pydanticv2
+def test_get(client: TestClient):
+    response = client.get("/")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"width": 3, "length": 4, "area": 12}
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/": {
+                "get": {
+                    "summary": "Read Root",
+                    "operationId": "read_root__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Rectangle"}
+                                }
+                            },
+                        }
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Rectangle": {
+                    "properties": {
+                        "width": {"type": "integer", "title": "Width"},
+                        "length": {"type": "integer", "title": "Length"},
+                        "area": {"type": "integer", "title": "Area", "readOnly": True},
+                    },
+                    "type": "object",
+                    "required": ["width", "length", "area"],
+                    "title": "Rectangle",
+                }
+            }
+        },
+    }
diff --git a/tests/test_datastructures.py b/tests/test_datastructures.py
index b91467265..7e57d525c 100644
--- a/tests/test_datastructures.py
+++ b/tests/test_datastructures.py
@@ -1,3 +1,4 @@
+import io
 from pathlib import Path
 from typing import List
 
@@ -52,3 +53,20 @@ def test_upload_file_is_closed(tmp_path: Path):
 
     assert testing_file_store
     assert testing_file_store[0].file.closed
+
+
+# For UploadFile coverage, segments copied from Starlette tests
+
+
+@pytest.mark.anyio
+async def test_upload_file():
+    stream = io.BytesIO(b"data")
+    file = UploadFile(filename="file", file=stream, size=4)
+    assert await file.read() == b"data"
+    assert file.size == 4
+    await file.write(b" and more data!")
+    assert await file.read() == b""
+    assert file.size == 19
+    await file.seek(0)
+    assert await file.read() == b"data and more data!"
+    await file.close()
diff --git a/tests/test_filter_pydantic_sub_model_pv2.py b/tests/test_filter_pydantic_sub_model_pv2.py
index 656332a01..9097d2ce5 100644
--- a/tests/test_filter_pydantic_sub_model_pv2.py
+++ b/tests/test_filter_pydantic_sub_model_pv2.py
@@ -1,7 +1,7 @@
 from typing import Optional
 
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import HasRepr, IsDict, IsOneOf
 from fastapi import Depends, FastAPI
 from fastapi.exceptions import ResponseValidationError
 from fastapi.testclient import TestClient
@@ -12,7 +12,7 @@ from .utils import needs_pydanticv2
 
 @pytest.fixture(name="client")
 def get_client():
-    from pydantic import BaseModel, FieldValidationInfo, field_validator
+    from pydantic import BaseModel, ValidationInfo, field_validator
 
     app = FastAPI()
 
@@ -28,7 +28,7 @@ def get_client():
         foo: ModelB
 
         @field_validator("name")
-        def lower_username(cls, name: str, info: FieldValidationInfo):
+        def lower_username(cls, name: str, info: ValidationInfo):
             if not name.endswith("A"):
                 raise ValueError("name must end in A")
             return name
@@ -66,7 +66,7 @@ def test_validator_is_cloned(client: TestClient):
                 "loc": ("response", "name"),
                 "msg": "Value error, name must end in A",
                 "input": "modelX",
-                "ctx": {"error": "name must end in A"},
+                "ctx": {"error": HasRepr("ValueError('name must end in A')")},
                 "url": match_pydantic_error_url("value_error"),
             }
         )
@@ -139,7 +139,11 @@ def test_openapi_schema(client: TestClient):
                 },
                 "ModelA": {
                     "title": "ModelA",
-                    "required": ["name", "foo"],
+                    "required": IsOneOf(
+                        ["name", "description", "foo"],
+                        # TODO remove when deprecating Pydantic v1
+                        ["name", "foo"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_jsonable_encoder.py b/tests/test_jsonable_encoder.py
index ff3033ecd..7c8338ff3 100644
--- a/tests/test_jsonable_encoder.py
+++ b/tests/test_jsonable_encoder.py
@@ -247,8 +247,9 @@ def test_encode_model_with_pure_path():
             class Config:
                 arbitrary_types_allowed = True
 
-    obj = ModelWithPath(path=PurePath("/foo", "bar"))
-    assert jsonable_encoder(obj) == {"path": "/foo/bar"}
+    test_path = PurePath("/foo", "bar")
+    obj = ModelWithPath(path=test_path)
+    assert jsonable_encoder(obj) == {"path": str(test_path)}
 
 
 def test_encode_model_with_pure_posix_path():
diff --git a/tests/test_multi_body_errors.py b/tests/test_multi_body_errors.py
index aa989c612..a51ca7253 100644
--- a/tests/test_multi_body_errors.py
+++ b/tests/test_multi_body_errors.py
@@ -51,7 +51,7 @@ def test_jsonable_encoder_requiring_error():
                     "loc": ["body", 0, "age"],
                     "msg": "Input should be greater than 0",
                     "input": -1.0,
-                    "ctx": {"gt": 0.0},
+                    "ctx": {"gt": 0},
                     "url": match_pydantic_error_url("greater_than"),
                 }
             ]
@@ -89,6 +89,7 @@ def test_put_incorrect_body_multiple():
                     "loc": ["body", 0, "age"],
                     "msg": "Input should be a valid decimal",
                     "input": "five",
+                    "url": match_pydantic_error_url("decimal_parsing"),
                 },
                 {
                     "type": "missing",
@@ -102,6 +103,7 @@ def test_put_incorrect_body_multiple():
                     "loc": ["body", 1, "age"],
                     "msg": "Input should be a valid decimal",
                     "input": "six",
+                    "url": match_pydantic_error_url("decimal_parsing"),
                 },
             ]
         }
diff --git a/tests/test_openapi_examples.py b/tests/test_openapi_examples.py
new file mode 100644
index 000000000..6597e5058
--- /dev/null
+++ b/tests/test_openapi_examples.py
@@ -0,0 +1,458 @@
+from typing import Union
+
+from dirty_equals import IsDict
+from fastapi import Body, Cookie, FastAPI, Header, Path, Query
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    data: str
+
+
+@app.post("/examples/")
+def examples(
+    item: Item = Body(
+        examples=[
+            {"data": "Data in Body examples, example1"},
+        ],
+        openapi_examples={
+            "Example One": {
+                "summary": "Example One Summary",
+                "description": "Example One Description",
+                "value": {"data": "Data in Body examples, example1"},
+            },
+            "Example Two": {
+                "value": {"data": "Data in Body examples, example2"},
+            },
+        },
+    ),
+):
+    return item
+
+
+@app.get("/path_examples/{item_id}")
+def path_examples(
+    item_id: str = Path(
+        examples=[
+            "json_schema_item_1",
+            "json_schema_item_2",
+        ],
+        openapi_examples={
+            "Path One": {
+                "summary": "Path One Summary",
+                "description": "Path One Description",
+                "value": "item_1",
+            },
+            "Path Two": {
+                "value": "item_2",
+            },
+        },
+    ),
+):
+    return item_id
+
+
+@app.get("/query_examples/")
+def query_examples(
+    data: Union[str, None] = Query(
+        default=None,
+        examples=[
+            "json_schema_query1",
+            "json_schema_query2",
+        ],
+        openapi_examples={
+            "Query One": {
+                "summary": "Query One Summary",
+                "description": "Query One Description",
+                "value": "query1",
+            },
+            "Query Two": {
+                "value": "query2",
+            },
+        },
+    ),
+):
+    return data
+
+
+@app.get("/header_examples/")
+def header_examples(
+    data: Union[str, None] = Header(
+        default=None,
+        examples=[
+            "json_schema_header1",
+            "json_schema_header2",
+        ],
+        openapi_examples={
+            "Header One": {
+                "summary": "Header One Summary",
+                "description": "Header One Description",
+                "value": "header1",
+            },
+            "Header Two": {
+                "value": "header2",
+            },
+        },
+    ),
+):
+    return data
+
+
+@app.get("/cookie_examples/")
+def cookie_examples(
+    data: Union[str, None] = Cookie(
+        default=None,
+        examples=["json_schema_cookie1", "json_schema_cookie2"],
+        openapi_examples={
+            "Cookie One": {
+                "summary": "Cookie One Summary",
+                "description": "Cookie One Description",
+                "value": "cookie1",
+            },
+            "Cookie Two": {
+                "value": "cookie2",
+            },
+        },
+    ),
+):
+    return data
+
+
+client = TestClient(app)
+
+
+def test_call_api():
+    response = client.post("/examples/", json={"data": "example1"})
+    assert response.status_code == 200, response.text
+
+    response = client.get("/path_examples/foo")
+    assert response.status_code == 200, response.text
+
+    response = client.get("/query_examples/")
+    assert response.status_code == 200, response.text
+
+    response = client.get("/header_examples/")
+    assert response.status_code == 200, response.text
+
+    response = client.get("/cookie_examples/")
+    assert response.status_code == 200, response.text
+
+
+def test_openapi_schema():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/examples/": {
+                "post": {
+                    "summary": "Examples",
+                    "operationId": "examples_examples__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "allOf": [{"$ref": "#/components/schemas/Item"}],
+                                    "title": "Item",
+                                    "examples": [
+                                        {"data": "Data in Body examples, example1"}
+                                    ],
+                                },
+                                "examples": {
+                                    "Example One": {
+                                        "summary": "Example One Summary",
+                                        "description": "Example One Description",
+                                        "value": {
+                                            "data": "Data in Body examples, example1"
+                                        },
+                                    },
+                                    "Example Two": {
+                                        "value": {
+                                            "data": "Data in Body examples, example2"
+                                        }
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/path_examples/{item_id}": {
+                "get": {
+                    "summary": "Path Examples",
+                    "operationId": "path_examples_path_examples__item_id__get",
+                    "parameters": [
+                        {
+                            "name": "item_id",
+                            "in": "path",
+                            "required": True,
+                            "schema": {
+                                "type": "string",
+                                "examples": [
+                                    "json_schema_item_1",
+                                    "json_schema_item_2",
+                                ],
+                                "title": "Item Id",
+                            },
+                            "examples": {
+                                "Path One": {
+                                    "summary": "Path One Summary",
+                                    "description": "Path One Description",
+                                    "value": "item_1",
+                                },
+                                "Path Two": {"value": "item_2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/query_examples/": {
+                "get": {
+                    "summary": "Query Examples",
+                    "operationId": "query_examples_query_examples__get",
+                    "parameters": [
+                        {
+                            "name": "data",
+                            "in": "query",
+                            "required": False,
+                            "schema": IsDict(
+                                {
+                                    "anyOf": [{"type": "string"}, {"type": "null"}],
+                                    "examples": [
+                                        "json_schema_query1",
+                                        "json_schema_query2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            )
+                            | IsDict(
+                                # TODO: remove when deprecating Pydantic v1
+                                {
+                                    "examples": [
+                                        "json_schema_query1",
+                                        "json_schema_query2",
+                                    ],
+                                    "type": "string",
+                                    "title": "Data",
+                                }
+                            ),
+                            "examples": {
+                                "Query One": {
+                                    "summary": "Query One Summary",
+                                    "description": "Query One Description",
+                                    "value": "query1",
+                                },
+                                "Query Two": {"value": "query2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/header_examples/": {
+                "get": {
+                    "summary": "Header Examples",
+                    "operationId": "header_examples_header_examples__get",
+                    "parameters": [
+                        {
+                            "name": "data",
+                            "in": "header",
+                            "required": False,
+                            "schema": IsDict(
+                                {
+                                    "anyOf": [{"type": "string"}, {"type": "null"}],
+                                    "examples": [
+                                        "json_schema_header1",
+                                        "json_schema_header2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            )
+                            | IsDict(
+                                # TODO: remove when deprecating Pydantic v1
+                                {
+                                    "type": "string",
+                                    "examples": [
+                                        "json_schema_header1",
+                                        "json_schema_header2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            ),
+                            "examples": {
+                                "Header One": {
+                                    "summary": "Header One Summary",
+                                    "description": "Header One Description",
+                                    "value": "header1",
+                                },
+                                "Header Two": {"value": "header2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/cookie_examples/": {
+                "get": {
+                    "summary": "Cookie Examples",
+                    "operationId": "cookie_examples_cookie_examples__get",
+                    "parameters": [
+                        {
+                            "name": "data",
+                            "in": "cookie",
+                            "required": False,
+                            "schema": IsDict(
+                                {
+                                    "anyOf": [{"type": "string"}, {"type": "null"}],
+                                    "examples": [
+                                        "json_schema_cookie1",
+                                        "json_schema_cookie2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            )
+                            | IsDict(
+                                # TODO: remove when deprecating Pydantic v1
+                                {
+                                    "type": "string",
+                                    "examples": [
+                                        "json_schema_cookie1",
+                                        "json_schema_cookie2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            ),
+                            "examples": {
+                                "Cookie One": {
+                                    "summary": "Cookie One Summary",
+                                    "description": "Cookie One Description",
+                                    "value": "cookie1",
+                                },
+                                "Cookie Two": {"value": "cookie2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {"data": {"type": "string", "title": "Data"}},
+                    "type": "object",
+                    "required": ["data"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_openapi_separate_input_output_schemas.py b/tests/test_openapi_separate_input_output_schemas.py
new file mode 100644
index 000000000..aeb85f735
--- /dev/null
+++ b/tests/test_openapi_separate_input_output_schemas.py
@@ -0,0 +1,494 @@
+from typing import List, Optional
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+
+from .utils import PYDANTIC_V2, needs_pydanticv2
+
+
+class SubItem(BaseModel):
+    subname: str
+    sub_description: Optional[str] = None
+    tags: List[str] = []
+    if PYDANTIC_V2:
+        model_config = {"json_schema_serialization_defaults_required": True}
+
+
+class Item(BaseModel):
+    name: str
+    description: Optional[str] = None
+    sub: Optional[SubItem] = None
+    if PYDANTIC_V2:
+        model_config = {"json_schema_serialization_defaults_required": True}
+
+
+def get_app_client(separate_input_output_schemas: bool = True) -> TestClient:
+    app = FastAPI(separate_input_output_schemas=separate_input_output_schemas)
+
+    @app.post("/items/")
+    def create_item(item: Item):
+        return item
+
+    @app.post("/items-list/")
+    def create_item_list(item: List[Item]):
+        return item
+
+    @app.get("/items/")
+    def read_items() -> List[Item]:
+        return [
+            Item(
+                name="Portal Gun",
+                description="Device to travel through the multi-rick-verse",
+                sub=SubItem(subname="subname"),
+            ),
+            Item(name="Plumbus"),
+        ]
+
+    client = TestClient(app)
+    return client
+
+
+def test_create_item():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    response = client.post("/items/", json={"name": "Plumbus"})
+    response2 = client_no.post("/items/", json={"name": "Plumbus"})
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == {"name": "Plumbus", "description": None, "sub": None}
+    )
+
+
+def test_create_item_with_sub():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    data = {
+        "name": "Plumbus",
+        "sub": {"subname": "SubPlumbus", "sub_description": "Sub WTF"},
+    }
+    response = client.post("/items/", json=data)
+    response2 = client_no.post("/items/", json=data)
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == {
+            "name": "Plumbus",
+            "description": None,
+            "sub": {"subname": "SubPlumbus", "sub_description": "Sub WTF", "tags": []},
+        }
+    )
+
+
+def test_create_item_list():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    data = [
+        {"name": "Plumbus"},
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+    ]
+    response = client.post("/items-list/", json=data)
+    response2 = client_no.post("/items-list/", json=data)
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == [
+            {"name": "Plumbus", "description": None, "sub": None},
+            {
+                "name": "Portal Gun",
+                "description": "Device to travel through the multi-rick-verse",
+                "sub": None,
+            },
+        ]
+    )
+
+
+def test_read_items():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    response = client.get("/items/")
+    response2 = client_no.get("/items/")
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == [
+            {
+                "name": "Portal Gun",
+                "description": "Device to travel through the multi-rick-verse",
+                "sub": {"subname": "subname", "sub_description": None, "tags": []},
+            },
+            {"name": "Plumbus", "description": None, "sub": None},
+        ]
+    )
+
+
+@needs_pydanticv2
+def test_openapi_schema():
+    client = get_app_client()
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {
+                                            "$ref": "#/components/schemas/Item-Output"
+                                        },
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            },
+            "/items-list/": {
+                "post": {
+                    "summary": "Create Item List",
+                    "operationId": "create_item_list_items_list__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "items": {
+                                        "$ref": "#/components/schemas/Item-Input"
+                                    },
+                                    "type": "array",
+                                    "title": "Item",
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item-Input": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "sub": {
+                            "anyOf": [
+                                {"$ref": "#/components/schemas/SubItem-Input"},
+                                {"type": "null"},
+                            ]
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "Item-Output": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "sub": {
+                            "anyOf": [
+                                {"$ref": "#/components/schemas/SubItem-Output"},
+                                {"type": "null"},
+                            ]
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name", "description", "sub"],
+                    "title": "Item",
+                },
+                "SubItem-Input": {
+                    "properties": {
+                        "subname": {"type": "string", "title": "Subname"},
+                        "sub_description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Sub Description",
+                        },
+                        "tags": {
+                            "items": {"type": "string"},
+                            "type": "array",
+                            "title": "Tags",
+                            "default": [],
+                        },
+                    },
+                    "type": "object",
+                    "required": ["subname"],
+                    "title": "SubItem",
+                },
+                "SubItem-Output": {
+                    "properties": {
+                        "subname": {"type": "string", "title": "Subname"},
+                        "sub_description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Sub Description",
+                        },
+                        "tags": {
+                            "items": {"type": "string"},
+                            "type": "array",
+                            "title": "Tags",
+                            "default": [],
+                        },
+                    },
+                    "type": "object",
+                    "required": ["subname", "sub_description", "tags"],
+                    "title": "SubItem",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
+
+
+@needs_pydanticv2
+def test_openapi_schema_no_separate():
+    client = get_app_client(separate_input_output_schemas=False)
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            },
+            "/items-list/": {
+                "post": {
+                    "summary": "Create Item List",
+                    "operationId": "create_item_list_items_list__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "items": {"$ref": "#/components/schemas/Item"},
+                                    "type": "array",
+                                    "title": "Item",
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "sub": {
+                            "anyOf": [
+                                {"$ref": "#/components/schemas/SubItem"},
+                                {"type": "null"},
+                            ]
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "SubItem": {
+                    "properties": {
+                        "subname": {"type": "string", "title": "Subname"},
+                        "sub_description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Sub Description",
+                        },
+                        "tags": {
+                            "items": {"type": "string"},
+                            "type": "array",
+                            "title": "Tags",
+                            "default": [],
+                        },
+                    },
+                    "type": "object",
+                    "required": ["subname"],
+                    "title": "SubItem",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_response_model_as_return_annotation.py b/tests/test_response_model_as_return_annotation.py
index 85dd450eb..6948430a1 100644
--- a/tests/test_response_model_as_return_annotation.py
+++ b/tests/test_response_model_as_return_annotation.py
@@ -277,13 +277,15 @@ def test_response_model_no_annotation_return_exact_dict():
 
 
 def test_response_model_no_annotation_return_invalid_dict():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model-no_annotation-return_invalid_dict")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_no_annotation_return_invalid_model():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model-no_annotation-return_invalid_model")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_no_annotation_return_dict_with_extra_data():
@@ -313,13 +315,15 @@ def test_no_response_model_annotation_return_exact_dict():
 
 
 def test_no_response_model_annotation_return_invalid_dict():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/no_response_model-annotation-return_invalid_dict")
+    assert "missing" in str(excinfo.value)
 
 
 def test_no_response_model_annotation_return_invalid_model():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/no_response_model-annotation-return_invalid_model")
+    assert "missing" in str(excinfo.value)
 
 
 def test_no_response_model_annotation_return_dict_with_extra_data():
@@ -395,13 +399,15 @@ def test_response_model_model1_annotation_model2_return_exact_dict():
 
 
 def test_response_model_model1_annotation_model2_return_invalid_dict():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model_model1-annotation_model2-return_invalid_dict")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_model1_annotation_model2_return_invalid_model():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model_model1-annotation_model2-return_invalid_model")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_model1_annotation_model2_return_dict_with_extra_data():
diff --git a/tests/test_router_events.py b/tests/test_router_events.py
index 1e940c581..71c2d896b 100644
--- a/tests/test_router_events.py
+++ b/tests/test_router_events.py
@@ -21,6 +21,9 @@ def state() -> State:
     return State()
 
 
+@pytest.mark.filterwarnings(
+    r"ignore:\s*on_event is deprecated, use lifespan event handlers instead.*:DeprecationWarning"
+)
 def test_router_events(state: State) -> None:
     app = FastAPI()
 
diff --git a/tests/test_schema_extra_examples.py b/tests/test_schema_extra_examples.py
index a1505afe2..b313f47e9 100644
--- a/tests/test_schema_extra_examples.py
+++ b/tests/test_schema_extra_examples.py
@@ -40,7 +40,7 @@ def create_app():
                 {"data": "Data in Body examples, example1"},
                 {"data": "Data in Body examples, example2"},
             ],
-        )
+        ),
     ):
         return item
 
@@ -54,7 +54,7 @@ def create_app():
                     {"data": "examples example_examples 1"},
                     {"data": "examples example_examples 2"},
                 ],
-            )
+            ),
         ):
             return item
 
diff --git a/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py b/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
index 25d6df3e9..13568a532 100644
--- a/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
+++ b/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
@@ -1,13 +1,20 @@
+import pytest
+from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from docs_src.async_sql_databases.tutorial001 import app
-
 from ...utils import needs_pydanticv1
 
 
+@pytest.fixture(name="app", scope="module")
+def get_app():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.async_sql_databases.tutorial001 import app
+    yield app
+
+
 # TODO: pv2 add version with Pydantic v2
 @needs_pydanticv1
-def test_create_read():
+def test_create_read(app: FastAPI):
     with TestClient(app) as client:
         note = {"text": "Foo bar", "completed": False}
         response = client.post("/notes/", json=note)
@@ -21,7 +28,7 @@ def test_create_read():
         assert data in response.json()
 
 
-def test_openapi_schema():
+def test_openapi_schema(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/openapi.json")
         assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001.py b/tests/test_tutorial/test_body_updates/test_tutorial001.py
index b02f7c81c..e586534a0 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001.py
@@ -1,7 +1,8 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 
 @pytest.fixture(name="client")
 def get_client():
@@ -36,7 +37,151 @@ def test_put(client: TestClient):
     }
 
 
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "get": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Read Item",
+                    "operationId": "read_item_items__item_id__get",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                },
+                "put": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "type": "object",
+                    "title": "Item",
+                    "properties": {
+                        "name": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Name",
+                        },
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                            "title": "Price",
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -124,36 +269,9 @@ def test_openapi_schema(client: TestClient):
                     "title": "Item",
                     "type": "object",
                     "properties": {
-                        "name": IsDict(
-                            {
-                                "title": "Name",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Name", "type": "string"}
-                        ),
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
-                        "price": IsDict(
-                            {
-                                "title": "Price",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Price", "type": "number"}
-                        ),
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
                         "tax": {"title": "Tax", "type": "number", "default": 10.5},
                         "tags": {
                             "title": "Tags",
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
index 4af2652a7..6bc969d43 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py310
+from ...utils import needs_py310, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -41,7 +40,152 @@ def test_put(client: TestClient):
 
 
 @needs_py310
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "get": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Read Item",
+                    "operationId": "read_item_items__item_id__get",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                },
+                "put": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "type": "object",
+                    "title": "Item",
+                    "properties": {
+                        "name": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Name",
+                        },
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                            "title": "Price",
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py310
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -129,36 +273,9 @@ def test_openapi_schema(client: TestClient):
                     "title": "Item",
                     "type": "object",
                     "properties": {
-                        "name": IsDict(
-                            {
-                                "title": "Name",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Name", "type": "string"}
-                        ),
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
-                        "price": IsDict(
-                            {
-                                "title": "Price",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Price", "type": "number"}
-                        ),
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
                         "tax": {"title": "Tax", "type": "number", "default": 10.5},
                         "tags": {
                             "title": "Tags",
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
index 832f45388..a1edb3370 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py39
+from ...utils import needs_py39, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -41,7 +40,152 @@ def test_put(client: TestClient):
 
 
 @needs_py39
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "get": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Read Item",
+                    "operationId": "read_item_items__item_id__get",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                },
+                "put": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "type": "object",
+                    "title": "Item",
+                    "properties": {
+                        "name": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Name",
+                        },
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                            "title": "Price",
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py39
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -129,36 +273,9 @@ def test_openapi_schema(client: TestClient):
                     "title": "Item",
                     "type": "object",
                     "properties": {
-                        "name": IsDict(
-                            {
-                                "title": "Name",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Name", "type": "string"}
-                        ),
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
-                        "price": IsDict(
-                            {
-                                "title": "Price",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Price", "type": "number"}
-                        ),
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
                         "tax": {"title": "Tax", "type": "number", "default": 10.5},
                         "tags": {
                             "title": "Tags",
diff --git a/docs_src/sql_databases_peewee/__init__.py b/tests/test_tutorial/test_configure_swagger_ui/__init__.py
similarity index 100%
rename from docs_src/sql_databases_peewee/__init__.py
rename to tests/test_tutorial/test_configure_swagger_ui/__init__.py
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial003.py b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial001.py
similarity index 95%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial003.py
rename to tests/test_tutorial/test_configure_swagger_ui/test_tutorial001.py
index 0184dd9f8..72db54bd2 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial003.py
+++ b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial001.py
@@ -1,6 +1,6 @@
 from fastapi.testclient import TestClient
 
-from docs_src.extending_openapi.tutorial003 import app
+from docs_src.configure_swagger_ui.tutorial001 import app
 
 client = TestClient(app)
 
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial004.py b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial002.py
similarity index 96%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial004.py
rename to tests/test_tutorial/test_configure_swagger_ui/test_tutorial002.py
index 4f7615126..166901188 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial004.py
+++ b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial002.py
@@ -1,6 +1,6 @@
 from fastapi.testclient import TestClient
 
-from docs_src.extending_openapi.tutorial004 import app
+from docs_src.configure_swagger_ui.tutorial002 import app
 
 client = TestClient(app)
 
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial005.py b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial003.py
similarity index 96%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial005.py
rename to tests/test_tutorial/test_configure_swagger_ui/test_tutorial003.py
index 24aeb93db..187e89ace 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial005.py
+++ b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial003.py
@@ -1,6 +1,6 @@
 from fastapi.testclient import TestClient
 
-from docs_src.extending_openapi.tutorial005 import app
+from docs_src.configure_swagger_ui.tutorial003 import app
 
 client = TestClient(app)
 
diff --git a/tests/test_tutorial/test_sql_databases_peewee/__init__.py b/tests/test_tutorial/test_custom_docs_ui/__init__.py
similarity index 100%
rename from tests/test_tutorial/test_sql_databases_peewee/__init__.py
rename to tests/test_tutorial/test_custom_docs_ui/__init__.py
diff --git a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
new file mode 100644
index 000000000..34a18b12c
--- /dev/null
+++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
@@ -0,0 +1,44 @@
+import os
+from pathlib import Path
+
+import pytest
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(scope="module")
+def client():
+    static_dir: Path = Path(os.getcwd()) / "static"
+    print(static_dir)
+    static_dir.mkdir(exist_ok=True)
+    from docs_src.custom_docs_ui.tutorial001 import app
+
+    with TestClient(app) as client:
+        yield client
+    static_dir.rmdir()
+
+
+def test_swagger_ui_html(client: TestClient):
+    response = client.get("/docs")
+    assert response.status_code == 200, response.text
+    assert (
+        "https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui-bundle.js" in response.text
+    )
+    assert "https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui.css" in response.text
+
+
+def test_swagger_ui_oauth2_redirect_html(client: TestClient):
+    response = client.get("/docs/oauth2-redirect")
+    assert response.status_code == 200, response.text
+    assert "window.opener.swaggerUIRedirectOauth2" in response.text
+
+
+def test_redoc_html(client: TestClient):
+    response = client.get("/redoc")
+    assert response.status_code == 200, response.text
+    assert "https://unpkg.com/redoc@next/bundles/redoc.standalone.js" in response.text
+
+
+def test_api(client: TestClient):
+    response = client.get("/users/john")
+    assert response.status_code == 200, response.text
+    assert response.json()["message"] == "Hello john"
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial002.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py
similarity index 95%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial002.py
rename to tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py
index 654db2e4c..712618807 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial002.py
+++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py
@@ -10,7 +10,7 @@ def client():
     static_dir: Path = Path(os.getcwd()) / "static"
     print(static_dir)
     static_dir.mkdir(exist_ok=True)
-    from docs_src.extending_openapi.tutorial002 import app
+    from docs_src.custom_docs_ui.tutorial002 import app
 
     with TestClient(app) as client:
         yield client
diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial002.py b/tests/test_tutorial/test_dataclasses/test_tutorial002.py
index 7d88e2861..4146f4cd6 100644
--- a/tests/test_tutorial/test_dataclasses/test_tutorial002.py
+++ b/tests/test_tutorial/test_dataclasses/test_tutorial002.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.dataclasses.tutorial002 import app
@@ -21,8 +21,7 @@ def test_get_item():
 def test_openapi_schema():
     response = client.get("/openapi.json")
     assert response.status_code == 200
-    data = response.json()
-    assert data == {
+    assert response.json() == {
         "openapi": "3.1.0",
         "info": {"title": "FastAPI", "version": "0.1.0"},
         "paths": {
@@ -47,7 +46,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "price", "tags", "description", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
@@ -57,7 +60,6 @@ def test_openapi_schema():
                                 "title": "Tags",
                                 "type": "array",
                                 "items": {"type": "string"},
-                                "default": [],
                             }
                         )
                         | IsDict(
diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial003.py b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
index 597757e09..dd0e36735 100644
--- a/tests/test_tutorial/test_dataclasses/test_tutorial003.py
+++ b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
@@ -1,8 +1,9 @@
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
 from docs_src.dataclasses.tutorial003 import app
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 client = TestClient(app)
 
 
@@ -52,6 +53,7 @@ def test_get_authors():
     ]
 
 
+@needs_pydanticv2
 def test_openapi_schema():
     response = client.get("/openapi.json")
     assert response.status_code == 200
@@ -136,22 +138,11 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "items": IsDict(
-                            {
-                                "title": "Items",
-                                "type": "array",
-                                "items": {"$ref": "#/components/schemas/Item"},
-                                "default": [],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {
-                                "title": "Items",
-                                "type": "array",
-                                "items": {"$ref": "#/components/schemas/Item"},
-                            }
-                        ),
+                        "items": {
+                            "title": "Items",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/Item"},
+                        },
                     },
                 },
                 "HTTPValidationError": {
@@ -171,16 +162,144 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/authors/{author_id}/items/": {
+                "post": {
+                    "summary": "Create Author Items",
+                    "operationId": "create_author_items_authors__author_id__items__post",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Author Id", "type": "string"},
+                            "name": "author_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "title": "Items",
+                                    "type": "array",
+                                    "items": {"$ref": "#/components/schemas/Item"},
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Author"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/authors/": {
+                "get": {
+                    "summary": "Get Authors",
+                    "operationId": "get_authors_authors__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "title": "Response Get Authors Authors  Get",
+                                        "type": "array",
+                                        "items": {
+                                            "$ref": "#/components/schemas/Author"
+                                        },
+                                    }
+                                }
+                            },
+                        }
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "Author": {
+                    "title": "Author",
+                    "required": ["name"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "items": {
+                            "title": "Items",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/Item"},
+                        },
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
                     },
                 },
                 "ValidationError": {
diff --git a/tests/test_tutorial/test_events/test_tutorial001.py b/tests/test_tutorial/test_events/test_tutorial001.py
index a5bb299ac..f65b92d12 100644
--- a/tests/test_tutorial/test_events/test_tutorial001.py
+++ b/tests/test_tutorial/test_events/test_tutorial001.py
@@ -1,16 +1,23 @@
+import pytest
+from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from docs_src.events.tutorial001 import app
+
+@pytest.fixture(name="app", scope="module")
+def get_app():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.events.tutorial001 import app
+    yield app
 
 
-def test_events():
+def test_events(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/items/foo")
         assert response.status_code == 200, response.text
         assert response.json() == {"name": "Fighters"}
 
 
-def test_openapi_schema():
+def test_openapi_schema(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/openapi.json")
         assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_events/test_tutorial002.py b/tests/test_tutorial/test_events/test_tutorial002.py
index 81cbf4ab6..137294d73 100644
--- a/tests/test_tutorial/test_events/test_tutorial002.py
+++ b/tests/test_tutorial/test_events/test_tutorial002.py
@@ -1,9 +1,16 @@
+import pytest
+from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from docs_src.events.tutorial002 import app
+
+@pytest.fixture(name="app", scope="module")
+def get_app():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.events.tutorial002 import app
+    yield app
 
 
-def test_events():
+def test_events(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/items/")
         assert response.status_code == 200, response.text
@@ -12,7 +19,7 @@ def test_events():
         assert "Application shutdown" in log.read()
 
 
-def test_openapi_schema():
+def test_openapi_schema(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/openapi.json")
         assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_extra_models/test_tutorial003.py b/tests/test_tutorial/test_extra_models/test_tutorial003.py
index 21192b7db..0ccb99948 100644
--- a/tests/test_tutorial/test_extra_models/test_tutorial003.py
+++ b/tests/test_tutorial/test_extra_models/test_tutorial003.py
@@ -1,3 +1,4 @@
+from dirty_equals import IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.extra_models.tutorial003 import app
@@ -76,7 +77,11 @@ def test_openapi_schema():
             "schemas": {
                 "PlaneItem": {
                     "title": "PlaneItem",
-                    "required": ["description", "size"],
+                    "required": IsOneOf(
+                        ["description", "type", "size"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description", "size"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
@@ -86,7 +91,11 @@ def test_openapi_schema():
                 },
                 "CarItem": {
                     "title": "CarItem",
-                    "required": ["description"],
+                    "required": IsOneOf(
+                        ["description", "type"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
diff --git a/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py b/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py
index c17ddbbe1..b2fe65fd9 100644
--- a/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py
+++ b/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py
@@ -1,4 +1,5 @@
 import pytest
+from dirty_equals import IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -86,7 +87,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "PlaneItem": {
                     "title": "PlaneItem",
-                    "required": ["description", "size"],
+                    "required": IsOneOf(
+                        ["description", "type", "size"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description", "size"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
@@ -96,7 +101,11 @@ def test_openapi_schema(client: TestClient):
                 },
                 "CarItem": {
                     "title": "CarItem",
-                    "required": ["description"],
+                    "required": IsOneOf(
+                        ["description", "type"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
diff --git a/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py b/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py
index 9111fdb2f..dc67ec401 100644
--- a/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py
+++ b/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py
@@ -85,7 +85,7 @@ def test_openapi_schema():
                 "Subscription": {
                     "properties": {
                         "username": {"type": "string", "title": "Username"},
-                        "montly_fee": {"type": "number", "title": "Montly Fee"},
+                        "monthly_fee": {"type": "number", "title": "Monthly Fee"},
                         "start_date": {
                             "type": "string",
                             "format": "date-time",
@@ -93,7 +93,7 @@ def test_openapi_schema():
                         },
                     },
                     "type": "object",
-                    "required": ["username", "montly_fee", "start_date"],
+                    "required": ["username", "monthly_fee", "start_date"],
                     "title": "Subscription",
                 },
                 "ValidationError": {
diff --git a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
index dd123f48d..4f69e4646 100644
--- a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
+++ b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
@@ -1,8 +1,9 @@
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
 from docs_src.path_operation_advanced_configuration.tutorial004 import app
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 client = TestClient(app)
 
 
@@ -18,6 +19,7 @@ def test_query_params_str_validations():
     }
 
 
+@needs_pydanticv2
 def test_openapi_schema():
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
@@ -69,27 +71,112 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
index e7e9a982e..d3792e701 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
@@ -1,8 +1,9 @@
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
 from docs_src.path_operation_configuration.tutorial005 import app
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 client = TestClient(app)
 
 
@@ -18,6 +19,7 @@ def test_query_params_str_validations():
     }
 
 
+@needs_pydanticv2
 def test_openapi_schema():
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
@@ -69,27 +71,112 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "The created item",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
index ebfeb809c..a68deb3df 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py310
+from ...utils import needs_py310, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -27,6 +26,7 @@ def test_query_params_str_validations(client: TestClient):
 
 
 @needs_py310
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
@@ -78,27 +78,113 @@ def test_openapi_schema(client: TestClient):
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py310
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "The created item",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
index 8e79afe96..e17f2592d 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py39
+from ...utils import needs_py39, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -27,6 +26,7 @@ def test_query_params_str_validations(client: TestClient):
 
 
 @needs_py39
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
@@ -78,27 +78,113 @@ def test_openapi_schema(client: TestClient):
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py39
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "The created item",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Item"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_params/test_tutorial005.py b/tests/test_tutorial/test_path_params/test_tutorial005.py
index 90fa6adaf..2e4b0146b 100644
--- a/tests/test_tutorial/test_path_params/test_tutorial005.py
+++ b/tests/test_tutorial/test_path_params/test_tutorial005.py
@@ -33,9 +33,9 @@ def test_get_enums_invalid():
                 {
                     "type": "enum",
                     "loc": ["path", "model_name"],
-                    "msg": "Input should be 'alexnet','resnet' or 'lenet'",
+                    "msg": "Input should be 'alexnet', 'resnet' or 'lenet'",
                     "input": "foo",
-                    "ctx": {"expected": "'alexnet','resnet' or 'lenet'"},
+                    "ctx": {"expected": "'alexnet', 'resnet' or 'lenet'"},
                 }
             ]
         }
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003.py b/tests/test_tutorial/test_response_model/test_tutorial003.py
index 20221399b..384c8e0f1 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial003 import app
@@ -70,7 +70,11 @@ def test_openapi_schema():
             "schemas": {
                 "UserOut": {
                     "title": "UserOut",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003_01.py b/tests/test_tutorial/test_response_model/test_tutorial003_01.py
index e8f0658f4..3a6a0b20d 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003_01.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003_01.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial003_01 import app
@@ -70,7 +70,11 @@ def test_openapi_schema():
             "schemas": {
                 "BaseUser": {
                     "title": "BaseUser",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py b/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py
index a69f8cc8d..6985b9de6 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -79,7 +79,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "BaseUser": {
                     "title": "BaseUser",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003_py310.py b/tests/test_tutorial/test_response_model/test_tutorial003_py310.py
index 64dcd6cbd..3a3aee38a 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -79,7 +79,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "UserOut": {
                     "title": "UserOut",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial004.py b/tests/test_tutorial/test_response_model/test_tutorial004.py
index 8beb847d1..e9bde18dd 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial004.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial004.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial004 import app
@@ -79,7 +79,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax", "tags"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial004_py310.py b/tests/test_tutorial/test_response_model/test_tutorial004_py310.py
index 28eb88c34..6f8a3cbea 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial004_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial004_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -87,7 +87,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax", "tags"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial004_py39.py b/tests/test_tutorial/test_response_model/test_tutorial004_py39.py
index 9e1a21f8d..cfaa1eba2 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial004_py39.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial004_py39.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py39
@@ -87,7 +87,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax", "tags"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial005.py b/tests/test_tutorial/test_response_model/test_tutorial005.py
index 06e5d0fd1..b20864c07 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial005.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial005.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial005 import app
@@ -102,7 +102,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial005_py310.py b/tests/test_tutorial/test_response_model/test_tutorial005_py310.py
index 0f1566243..de552c8f2 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial005_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -112,7 +112,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial006.py b/tests/test_tutorial/test_response_model/test_tutorial006.py
index 6e6152b9f..1e47e2ead 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial006.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial006.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial006 import app
@@ -102,7 +102,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial006_py310.py b/tests/test_tutorial/test_response_model/test_tutorial006_py310.py
index 9a980ab5b..40058b12d 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial006_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial006_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -112,7 +112,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005.py
new file mode 100644
index 000000000..94a40ed5a
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005.py
@@ -0,0 +1,166 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py
new file mode 100644
index 000000000..da92f98f6
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py
@@ -0,0 +1,166 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_an import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py
new file mode 100644
index 000000000..9109cb14e
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py
@@ -0,0 +1,170 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_an_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+@needs_py310
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py
new file mode 100644
index 000000000..fd4ec0575
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py
@@ -0,0 +1,170 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+@needs_py39
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py
new file mode 100644
index 000000000..05df53422
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py
@@ -0,0 +1,170 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+@needs_py310
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_security/test_tutorial005.py b/tests/test_tutorial/test_security/test_tutorial005.py
index 22ae76f42..c669c306d 100644
--- a/tests/test_tutorial/test_security/test_tutorial005.py
+++ b/tests/test_tutorial/test_security/test_tutorial005.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.security.tutorial005 import (
@@ -267,7 +267,11 @@ def test_openapi_schema():
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_an.py b/tests/test_tutorial/test_security/test_tutorial005_an.py
index 07239cc89..aaab04f78 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_an.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_an.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.security.tutorial005_an import (
@@ -267,7 +267,11 @@ def test_openapi_schema():
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_an_py310.py b/tests/test_tutorial/test_security/test_tutorial005_an_py310.py
index 1ab836639..243d0773c 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_an_py310.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_an_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_an_py39.py b/tests/test_tutorial/test_security/test_tutorial005_an_py39.py
index 6aabbe04a..17a3f9aa2 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_an_py39.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_an_py39.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py39
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_py310.py b/tests/test_tutorial/test_security/test_tutorial005_py310.py
index c21884df8..06455cd63 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_py39.py b/tests/test_tutorial/test_security/test_tutorial005_py39.py
index 170c5d60b..9455bfb4e 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_py39.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_py39.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py39
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/__init__.py b/tests/test_tutorial/test_separate_openapi_schemas/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
new file mode 100644
index 000000000..cdfae9f8c
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
@@ -0,0 +1,133 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial001 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
new file mode 100644
index 000000000..3b22146f6
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
@@ -0,0 +1,136 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial001_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py310
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py310
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
new file mode 100644
index 000000000..991abe811
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
@@ -0,0 +1,136 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial001_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py39
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py39
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py
new file mode 100644
index 000000000..d2cf7945b
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py
@@ -0,0 +1,133 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial002 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py
new file mode 100644
index 000000000..89c9ce977
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py
@@ -0,0 +1,136 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial002_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py310
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py310
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py
new file mode 100644
index 000000000..6ac3d8f79
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py
@@ -0,0 +1,136 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial002_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py39
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py39
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py b/tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py
deleted file mode 100644
index 4350567d1..000000000
--- a/tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py
+++ /dev/null
@@ -1,454 +0,0 @@
-import time
-from pathlib import Path
-from unittest.mock import MagicMock
-
-import pytest
-from fastapi.testclient import TestClient
-
-from ...utils import needs_pydanticv1
-
-
-@pytest.fixture(scope="module")
-def client():
-    # Import while creating the client to create the DB after starting the test session
-    from docs_src.sql_databases_peewee.sql_app.main import app
-
-    test_db = Path("./test.db")
-    with TestClient(app) as c:
-        yield c
-    test_db.unlink()
-
-
-@needs_pydanticv1
-def test_create_user(client):
-    test_user = {"email": "johndoe@example.com", "password": "secret"}
-    response = client.post("/users/", json=test_user)
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert test_user["email"] == data["email"]
-    assert "id" in data
-    response = client.post("/users/", json=test_user)
-    assert response.status_code == 400, response.text
-
-
-@needs_pydanticv1
-def test_get_user(client):
-    response = client.get("/users/1")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert "email" in data
-    assert "id" in data
-
-
-@needs_pydanticv1
-def test_inexistent_user(client):
-    response = client.get("/users/999")
-    assert response.status_code == 404, response.text
-
-
-@needs_pydanticv1
-def test_get_users(client):
-    response = client.get("/users/")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert "email" in data[0]
-    assert "id" in data[0]
-
-
-time.sleep = MagicMock()
-
-
-@needs_pydanticv1
-def test_get_slowusers(client):
-    response = client.get("/slowusers/")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert "email" in data[0]
-    assert "id" in data[0]
-
-
-@needs_pydanticv1
-def test_create_item(client):
-    item = {"title": "Foo", "description": "Something that fights"}
-    response = client.post("/users/1/items/", json=item)
-    assert response.status_code == 200, response.text
-    item_data = response.json()
-    assert item["title"] == item_data["title"]
-    assert item["description"] == item_data["description"]
-    assert "id" in item_data
-    assert "owner_id" in item_data
-    response = client.get("/users/1")
-    assert response.status_code == 200, response.text
-    user_data = response.json()
-    item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
-    assert item_to_check["title"] == item["title"]
-    assert item_to_check["description"] == item["description"]
-    response = client.get("/users/1")
-    assert response.status_code == 200, response.text
-    user_data = response.json()
-    item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
-    assert item_to_check["title"] == item["title"]
-    assert item_to_check["description"] == item["description"]
-
-
-@needs_pydanticv1
-def test_read_items(client):
-    response = client.get("/items/")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert data
-    first_item = data[0]
-    assert "title" in first_item
-    assert "description" in first_item
-
-
-@needs_pydanticv1
-def test_openapi_schema(client):
-    response = client.get("/openapi.json")
-    assert response.status_code == 200, response.text
-    assert response.json() == {
-        "openapi": "3.1.0",
-        "info": {"title": "FastAPI", "version": "0.1.0"},
-        "paths": {
-            "/users/": {
-                "get": {
-                    "summary": "Read Users",
-                    "operationId": "read_users_users__get",
-                    "parameters": [
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Skip",
-                                "type": "integer",
-                                "default": 0,
-                            },
-                            "name": "skip",
-                            "in": "query",
-                        },
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Limit",
-                                "type": "integer",
-                                "default": 100,
-                            },
-                            "name": "limit",
-                            "in": "query",
-                        },
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "title": "Response Read Users Users  Get",
-                                        "type": "array",
-                                        "items": {"$ref": "#/components/schemas/User"},
-                                    }
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                },
-                "post": {
-                    "summary": "Create User",
-                    "operationId": "create_user_users__post",
-                    "requestBody": {
-                        "content": {
-                            "application/json": {
-                                "schema": {"$ref": "#/components/schemas/UserCreate"}
-                            }
-                        },
-                        "required": True,
-                    },
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {"$ref": "#/components/schemas/User"}
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                },
-            },
-            "/users/{user_id}": {
-                "get": {
-                    "summary": "Read User",
-                    "operationId": "read_user_users__user_id__get",
-                    "parameters": [
-                        {
-                            "required": True,
-                            "schema": {"title": "User Id", "type": "integer"},
-                            "name": "user_id",
-                            "in": "path",
-                        }
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {"$ref": "#/components/schemas/User"}
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-            "/users/{user_id}/items/": {
-                "post": {
-                    "summary": "Create Item For User",
-                    "operationId": "create_item_for_user_users__user_id__items__post",
-                    "parameters": [
-                        {
-                            "required": True,
-                            "schema": {"title": "User Id", "type": "integer"},
-                            "name": "user_id",
-                            "in": "path",
-                        }
-                    ],
-                    "requestBody": {
-                        "content": {
-                            "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemCreate"}
-                            }
-                        },
-                        "required": True,
-                    },
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {"$ref": "#/components/schemas/Item"}
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-            "/items/": {
-                "get": {
-                    "summary": "Read Items",
-                    "operationId": "read_items_items__get",
-                    "parameters": [
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Skip",
-                                "type": "integer",
-                                "default": 0,
-                            },
-                            "name": "skip",
-                            "in": "query",
-                        },
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Limit",
-                                "type": "integer",
-                                "default": 100,
-                            },
-                            "name": "limit",
-                            "in": "query",
-                        },
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "title": "Response Read Items Items  Get",
-                                        "type": "array",
-                                        "items": {"$ref": "#/components/schemas/Item"},
-                                    }
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-            "/slowusers/": {
-                "get": {
-                    "summary": "Read Slow Users",
-                    "operationId": "read_slow_users_slowusers__get",
-                    "parameters": [
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Skip",
-                                "type": "integer",
-                                "default": 0,
-                            },
-                            "name": "skip",
-                            "in": "query",
-                        },
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Limit",
-                                "type": "integer",
-                                "default": 100,
-                            },
-                            "name": "limit",
-                            "in": "query",
-                        },
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "title": "Response Read Slow Users Slowusers  Get",
-                                        "type": "array",
-                                        "items": {"$ref": "#/components/schemas/User"},
-                                    }
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-        },
-        "components": {
-            "schemas": {
-                "HTTPValidationError": {
-                    "title": "HTTPValidationError",
-                    "type": "object",
-                    "properties": {
-                        "detail": {
-                            "title": "Detail",
-                            "type": "array",
-                            "items": {"$ref": "#/components/schemas/ValidationError"},
-                        }
-                    },
-                },
-                "Item": {
-                    "title": "Item",
-                    "required": ["title", "id", "owner_id"],
-                    "type": "object",
-                    "properties": {
-                        "title": {"title": "Title", "type": "string"},
-                        "description": {"title": "Description", "type": "string"},
-                        "id": {"title": "Id", "type": "integer"},
-                        "owner_id": {"title": "Owner Id", "type": "integer"},
-                    },
-                },
-                "ItemCreate": {
-                    "title": "ItemCreate",
-                    "required": ["title"],
-                    "type": "object",
-                    "properties": {
-                        "title": {"title": "Title", "type": "string"},
-                        "description": {"title": "Description", "type": "string"},
-                    },
-                },
-                "User": {
-                    "title": "User",
-                    "required": ["email", "id", "is_active"],
-                    "type": "object",
-                    "properties": {
-                        "email": {"title": "Email", "type": "string"},
-                        "id": {"title": "Id", "type": "integer"},
-                        "is_active": {"title": "Is Active", "type": "boolean"},
-                        "items": {
-                            "title": "Items",
-                            "type": "array",
-                            "items": {"$ref": "#/components/schemas/Item"},
-                            "default": [],
-                        },
-                    },
-                },
-                "UserCreate": {
-                    "title": "UserCreate",
-                    "required": ["email", "password"],
-                    "type": "object",
-                    "properties": {
-                        "email": {"title": "Email", "type": "string"},
-                        "password": {"title": "Password", "type": "string"},
-                    },
-                },
-                "ValidationError": {
-                    "title": "ValidationError",
-                    "required": ["loc", "msg", "type"],
-                    "type": "object",
-                    "properties": {
-                        "loc": {
-                            "title": "Location",
-                            "type": "array",
-                            "items": {
-                                "anyOf": [{"type": "string"}, {"type": "integer"}]
-                            },
-                        },
-                        "msg": {"title": "Message", "type": "string"},
-                        "type": {"title": "Error Type", "type": "string"},
-                    },
-                },
-            }
-        },
-    }
diff --git a/tests/test_tutorial/test_testing/test_tutorial003.py b/tests/test_tutorial/test_testing/test_tutorial003.py
index d9e16390e..2a5d67071 100644
--- a/tests/test_tutorial/test_testing/test_tutorial003.py
+++ b/tests/test_tutorial/test_testing/test_tutorial003.py
@@ -1,5 +1,7 @@
-from docs_src.app_testing.tutorial003 import test_read_items
+import pytest
 
 
 def test_main():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.app_testing.tutorial003 import test_read_items
     test_read_items()
diff --git a/tests/test_webhooks_security.py b/tests/test_webhooks_security.py
index a1c7b18fb..21a694cb5 100644
--- a/tests/test_webhooks_security.py
+++ b/tests/test_webhooks_security.py
@@ -13,7 +13,7 @@ bearer_scheme = HTTPBearer()
 
 class Subscription(BaseModel):
     username: str
-    montly_fee: float
+    monthly_fee: float
     start_date: datetime
 
 
@@ -93,7 +93,7 @@ def test_openapi_schema():
                 "Subscription": {
                     "properties": {
                         "username": {"type": "string", "title": "Username"},
-                        "montly_fee": {"type": "number", "title": "Montly Fee"},
+                        "monthly_fee": {"type": "number", "title": "Monthly Fee"},
                         "start_date": {
                             "type": "string",
                             "format": "date-time",
@@ -101,7 +101,7 @@ def test_openapi_schema():
                         },
                     },
                     "type": "object",
-                    "required": ["username", "montly_fee", "start_date"],
+                    "required": ["username", "monthly_fee", "start_date"],
                     "title": "Subscription",
                 },
                 "ValidationError": {