diff --git a/docs/ru/docs/tutorial/path-operation-configuration.md b/docs/ru/docs/tutorial/path-operation-configuration.md index 3604e3bcf3181..013903add1cc0 100644 --- a/docs/ru/docs/tutorial/path-operation-configuration.md +++ b/docs/ru/docs/tutorial/path-operation-configuration.md @@ -31,12 +31,12 @@ {!> ../../../docs_src/path_operation_configuration/tutorial001.py!} ``` -Этот код состояния будет использован в ответе, и будет добавлен в схему OpenAPI. +Этот код состояния будет использован в ответе и будет добавлен в схему OpenAPI. !!! note "Технические детали" Вы также можете использовать `from starlette import status`. - **FastAPI** предоставляет тот же `starlette.status`, что и `fastapi.status` для удобства разработчкиа. Но идет он непросредственно от Starlette. + **FastAPI** предоставляет тот же `starlette.status` под псевдонимом `fastapi.status` для удобства разработчика. Но его источник - это непосредственно Starlette. ## Теги @@ -66,11 +66,11 @@ ### Теги с перечислениями -Если у вас большое приложение, под конец вы можете набрать **несколько тегов**, и вы можете хотеть убедиться в том, что всегда используете **один и тот же тег** для связанных *операций пути*. +Если у вас большое приложение, вы можете прийти к необходимости добавить **несколько тегов**, и возможно, вы захотите убедиться в том, что всегда используете **один и тот же тег** для связанных *операций пути*. -В этих случаях, имеет смысл хранить теги в `Enum`. +В этих случаях, имеет смысл хранить теги в классе `Enum`. -**FastAPI** поддерживает это также, как и с обычными строками: +**FastAPI** поддерживает это так же, как и в случае с обычными строками: ```Python hl_lines="1 8-10 13 18" {!../../../docs_src/path_operation_configuration/tutorial002b.py!} @@ -78,7 +78,7 @@ ## Краткое и развёрнутое содержание -Вы можете добавить `summary` и `description`: +Вы можете добавить параметры `summary` и `description`: === "Python 3.10+" @@ -100,9 +100,9 @@ ## Описание из строк документации -Так как описания обычно длинные и содержат много строк, вы можете объявить описание *операции пути* в функции строки документации и **FastAPI** прочитает её отсюда. +Так как описания обычно длинные и содержат много строк, вы можете объявить описание *операции пути* в функции строки документации и **FastAPI** прочитает её отсюда. -Вы можете использовать Markdown в строке документации, и оно будет интерпретировано и отображено корректно (с учетом отступа в строке документации). +Вы можете использовать Markdown в строке документации, и он будет интерпретирован и отображён корректно (с учетом отступа в строке документации). === "Python 3.10+" @@ -149,18 +149,18 @@ ``` !!! info "Дополнительная информация" - Помните, что `response_description` относится конкретно к ответу, а `description` в основном относится к *операциям пути*. + Помните, что `response_description` относится конкретно к ответу, а `description` относится к *операции пути* в целом. !!! check "Технические детали" OpenAPI указывает, что каждой *операции пути* необходимо описание ответа. - Если вдруг вы не укажите одно из них, то **FastAPI** автоматически сгенерирует один из "Удачных ответов". + Если вдруг вы не укажете его, то **FastAPI** автоматически сгенерирует это описание с текстом "Successful response". ## Обозначение *операции пути* как устаревшей -Если вам необходимо пометить *операцию пути* как устаревшую, но без её удаления, передайте параметр `deprecated`: +Если вам необходимо пометить *операцию пути* как устаревшую, при этом не удаляя её, передайте параметр `deprecated`: ```Python hl_lines="16" {!../../../docs_src/path_operation_configuration/tutorial006.py!} @@ -170,7 +170,7 @@ -Проверьте, как устаревшие и не-устаревшие *операции пути* будут выглядеть: +Проверьте, как будут выглядеть устаревшие и не устаревшие *операции пути*: