🌐 Add Russian translation for `docs/ru/docs/deployment/versions.md` #4985

emp7yhead · 2022-06-04T15:53:41Z

Translate docs/ru/docs/deployment/versions.md and add deploy menu in Russian.
related: #1362

codecov · 2022-06-04T15:54:38Z

Codecov Report

Merging #4985 (9ff9f92) into master (1876ebc) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##            master     #4985   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          532       533    +1     
  Lines        13672     13755   +83     
=========================================
+ Hits         13672     13755   +83

Impacted Files	Coverage Δ
fastapi/utils.py	`100.00% <0.00%> (ø)`
fastapi/routing.py	`100.00% <0.00%> (ø)`
fastapi/encoders.py	`100.00% <0.00%> (ø)`
fastapi/openapi/docs.py	`100.00% <0.00%> (ø)`
fastapi/openapi/utils.py	`100.00% <0.00%> (ø)`
fastapi/openapi/constants.py	`100.00% <0.00%> (ø)`
fastapi/dependencies/utils.py	`100.00% <0.00%> (ø)`
tests/test_dependency_cache.py	`100.00% <0.00%> (ø)`
tests/test_jsonable_encoder.py	`100.00% <0.00%> (ø)`
tests/test_validate_response.py	`100.00% <0.00%> (ø)`
... and 2 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

github-actions · 2022-06-04T15:57:06Z

📝 Docs preview for commit 8c9ee7a at: https://629b80a66924e50eb6fb1f77--fastapi.netlify.app

Winand · 2022-08-19T08:43:23Z

docs/ru/docs/deployment/versions.md

@@ -0,0 +1,87 @@
+# О версиях FastAPI
+
+**FastAPI** уже используется в продакшене во многих приложениях и системах. Покрытие тестами поддерживается на уровне 100%. Однако, его разработка все еще продолжается.


"Однако его разработка" https://www.nkj.ru/archive/articles/23602

Winand · 2022-08-19T08:59:09Z

docs/ru/docs/deployment/versions.md

+
+## Доступные версии
+
+Вы можете увидеть доступные версии (например - проверить последнюю на данный момент) в [Release Notes](../release-notes.md){.internal-link target=_blank}.


(например, проверить последнюю на данный момент)

Winand · 2022-08-19T09:06:18Z

docs/ru/docs/deployment/versions.md

+
+Следуя соглашению о Семантическом Версионировании, любые версии ниже `1.0.0` потенциально могут добавить обратно несовместимые изменения.
+
+FastAPI следует соглашению в том, что любые изменения "ПАТЧ"-версии предназначены для исправления багов и обратно совместимых изменений.


Может быть так лучше? "для исправления багов и внесения обратно совместимых изменений"

Winand · 2022-08-19T09:09:02Z

docs/ru/docs/deployment/versions.md

+
+После создания тестов вы можете обновить свою версию **FastAPI** до более новой. После это следует убедиться, что ваш код работает корректно, запустив тесты.
+
+Если все работает корректно или после внесения необходимых изменений все ваши тесты проходят, только тогда вы можете закрепить вашу новую версию `fastapi`.


(запятая) все работает корректно, или после внесения необходимых изменений все ваши тесты проходят

Winand · 2022-08-19T09:10:18Z

docs/ru/docs/deployment/versions.md

+
+Разные версии **FastAPI** будут использовать более новые версии Starlette.
+
+Так что решение о используемой версии Starlette, вы можете оставить **FastAPI**.


об используемой

github-actions · 2022-08-20T05:47:28Z

📝 Docs preview for commit f184d09 at: https://6300753c1f6b4b0af3bc6edd--fastapi.netlify.app

Xewus

В целом хорошо. Небольшие косметические правки и пара непереведённых слов.

Xewus · 2022-08-22T18:50:10Z

docs/ru/docs/deployment/versions.md

+fastapi==0.45.0
+```
+
+что значит, что вы будете использовать именно версию `0.45.0`.


что значит, что

не очень красиво с такими повторами...

Это означает

Сие гласит

Xewus · 2022-08-22T18:50:35Z

docs/ru/docs/deployment/versions.md

+fastapi>=0.45.0,<0.46.0
+```
+
+что значит, что вы используете версии `0.45.0` или выше, но меньше чем `0.46.0`. Например, версия `0.45.2` все еще будет подходить.


что значит, что

не очень красиво с такими повторами...

Это означает

Сие гласит

Xewus · 2022-08-22T18:51:58Z

docs/ru/docs/deployment/versions.md

+
+Первым делом вам следует "закрепить" конкретную последнюю используемую версию **FastAPI**, которая корректно работает с вашим приложением.
+
+Например, вы используете версию `0.45.0` в приложении.


Например, вы используете версию 0.45.0 в приложении.

Например, в своём приложении.вы используете версию 0.45.0.

Xewus · 2022-08-22T18:54:39Z

docs/ru/docs/deployment/versions.md

+
+что значит, что вы используете версии `0.45.0` или выше, но меньше чем `0.46.0`. Например, версия `0.45.2` все еще будет подходить.
+
+Если вы используете любой другой инструмент для организации установки, например Poetry, Pipenv или др., у них у всех имеется способ определения специфической версии для ваших пакетов.


для организации установки,

Мне чаще встречается - "управление зависимостями".

Xewus · 2022-08-22T18:56:14Z

docs/ru/docs/deployment/versions.md

+
+## Доступные версии
+
+Вы можете увидеть доступные версии (например, проверить последнюю на данный момент) в [Release Notes](../release-notes.md){.internal-link target=_blank}.


увидеть

Посмотреть

Xewus · 2022-08-22T18:58:54Z

docs/ru/docs/deployment/versions.md

+
+FastAPI следует соглашению в том, что любые изменения "ПАТЧ"-версии предназначены для исправления багов и внесения обратно совместимых изменений.
+
+!!! tip


Не переведено.

Подсказка/уточнение

Я просто решил сохранить единообразие. В "Введение в аннотации типов" перевод подсказок и иных сносок отсутствует.

@Xewus если я правильно помню, !!! tip преобразуется в такой блок с подсказкой, если перевести, то сломается

Возможно, Вы правы, завтра постараюсь пощупать этот случай.
Но вообще, чтобы проверить - сломается или нет, к фреймворку прилагаются инструменты для проверки локально - как будет реально выглядеть ваш перевод.
В целом, по данному переводу у меня особых претензий нет, я лишь предложил некоторые варианты, которые, по моему скромному мнению, звучат более "русскоязычно", потому и не нажимал "Требуются изменения".

@Xewus если я правильно помню, !!! tip преобразуется в такой блок с подсказкой, если перевести, то сломается

У корейцев работает.

Завтра проверю. Если локально проблем не будет, сделаю необходимые изменения.

Xewus · 2022-08-22T18:59:45Z

docs/ru/docs/deployment/versions.md

+
+Обратно несовместимые изменения и новые функции добавляются в "МИНОРНЫЕ" версии.
+
+!!! tip


Не переведено.

Подсказка/уточнение

Xewus · 2022-08-22T19:00:51Z

docs/ru/docs/deployment/versions.md

+!!! tip
+    "МИНОРНАЯ" версия - это число в середине. Например, в `0.2.3` МИНОРНАЯ версия - это `2`.
+
+## Обновление версии FastAPI


версии

Й

Xewus · 2022-08-22T19:02:03Z

docs/ru/docs/deployment/versions.md

+
+Вам следует добавить тесты для вашего приложения.
+
+С помощью **FastAPI** это очень просто (благодаря Starlette), см. документацию: [Testing](../tutorial/testing.md){.internal-link target=_blank}


Testing

Не переведено.

Xewus · 2022-08-22T19:10:01Z

docs/ru/mkdocs.yml

@@ -57,6 +57,8 @@ nav:
  - uk: /uk/
  - zh: /zh/
 - async.md
+- Развёртывание:
+  - deployment/versions.md


Хорошо, что не забыли про этот файл.

github-actions · 2022-08-24T15:01:33Z

📝 Docs preview for commit 9ff9f92 at: https://63063d19a9359c00680c8f92--fastapi.netlify.app

emp7yhead · 2022-08-24T15:01:36Z

@Xewus @Winand, я исправил указанные замечания.
Блоки с подсказками и вправду без проблем переводятся, проверил локально. Может быть в рамках этого PR и на остальных страницах сделать перевод названий блоков?

Xewus · 2022-08-24T17:08:52Z

@emp7yhead , когда пытался перевести что-то, Себастьян попросил делать отдельный ПР на каждую страницу, соответственно, на исправления тоже лучше отдельный ПР делать.

Winand · 2022-08-24T22:10:53Z

docs/ru/docs/deployment/versions.md

+
+Часто добавляются новые функции, регулярно исправляются баги, код продолжает постоянно совершенствоваться.
+
+По указанным причинам текущие версии до сих пор `0.x.x`. Это говорит о том, что каждая версия может содержать обратно несовместимые изменения, следуя <a href="https://semver.org/" class="external-link" target="_blank">соглашению о Семантическом Версионировании</a>.


На русском, как будто бы, глагола не достаёт: "текущие версии до сих пор 0.x.x". Может быть "текущие версии до сих пор не достигли 1.x.x", раз речь о семвере? Впрочем, если над этим слишком долго думать, то выйдет уже 1.0 .))

tiangolo · 2022-08-26T14:43:53Z

Great, thanks @emp7yhead! 🚀 🍰

Thanks for the reviews @Winand and @Xewus! ☕

emp7yhead added 3 commits June 4, 2022 20:32

Add: original file in docs/ru/docs/deployment

49ab43e

Add russian translation for versions.md

cc41b82

Update mkdocs.yml

8c9ee7a

tiangolo changed the title ~~Add Russian translation for docs/ru/docs/deployment/versions.md~~ 🌐 Add Russian translation for docs/ru/docs/deployment/versions.md Aug 18, 2022

tiangolo added lang-all Translations lang-ru Russian translations awaiting-review labels Aug 18, 2022

github-actions bot mentioned this pull request Aug 18, 2022

Russian translation #1362

Closed

Winand reviewed Aug 19, 2022

View reviewed changes

Fix typo

f184d09

Xewus reviewed Aug 22, 2022

View reviewed changes

Fix typos

9ff9f92

Xewus approved these changes Aug 24, 2022

View reviewed changes

Winand reviewed Aug 24, 2022

View reviewed changes

Winand approved these changes Aug 24, 2022

View reviewed changes

github-actions bot added approved-2 and removed awaiting-review labels Aug 25, 2022

tiangolo merged commit fa92dbf into fastapi:master Aug 26, 2022

emp7yhead deleted the add-translation-ru-deployment-versions branch August 28, 2022 13:17

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🌐 Add Russian translation for `docs/ru/docs/deployment/versions.md` #4985

🌐 Add Russian translation for `docs/ru/docs/deployment/versions.md` #4985

emp7yhead commented Jun 4, 2022

codecov bot commented Jun 4, 2022 •

edited

Loading

github-actions bot commented Jun 4, 2022

Winand Aug 19, 2022

Winand Aug 19, 2022

Winand Aug 19, 2022

Winand Aug 19, 2022

Winand Aug 19, 2022

github-actions bot commented Aug 20, 2022

Xewus left a comment

Xewus Aug 22, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

emp7yhead Aug 23, 2022

Winand Aug 23, 2022

Xewus Aug 23, 2022 •

edited

Loading

Xewus Aug 23, 2022

emp7yhead Aug 23, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

Xewus Aug 22, 2022

github-actions bot commented Aug 24, 2022

emp7yhead commented Aug 24, 2022

Xewus commented Aug 24, 2022

Winand Aug 24, 2022 •

edited

Loading

tiangolo commented Aug 26, 2022

		@@ -0,0 +1,87 @@
		# О версиях FastAPI

		FastAPI уже используется в продакшене во многих приложениях и системах. Покрытие тестами поддерживается на уровне 100%. Однако, его разработка все еще продолжается.


		## Доступные версии

		Вы можете увидеть доступные версии (например - проверить последнюю на данный момент) в [Release Notes](../release-notes.md){.internal-link target=_blank}.


		Следуя соглашению о Семантическом Версионировании, любые версии ниже `1.0.0` потенциально могут добавить обратно несовместимые изменения.

		FastAPI следует соглашению в том, что любые изменения "ПАТЧ"-версии предназначены для исправления багов и обратно совместимых изменений.


		После создания тестов вы можете обновить свою версию FastAPI до более новой. После это следует убедиться, что ваш код работает корректно, запустив тесты.

		Если все работает корректно или после внесения необходимых изменений все ваши тесты проходят, только тогда вы можете закрепить вашу новую версию `fastapi`.


		Разные версии FastAPI будут использовать более новые версии Starlette.

		Так что решение о используемой версии Starlette, вы можете оставить FastAPI.


		Первым делом вам следует "закрепить" конкретную последнюю используемую версию FastAPI, которая корректно работает с вашим приложением.

		Например, вы используете версию `0.45.0` в приложении.


		что значит, что вы используете версии `0.45.0` или выше, но меньше чем `0.46.0`. Например, версия `0.45.2` все еще будет подходить.

		Если вы используете любой другой инструмент для организации установки, например Poetry, Pipenv или др., у них у всех имеется способ определения специфической версии для ваших пакетов.


		FastAPI следует соглашению в том, что любые изменения "ПАТЧ"-версии предназначены для исправления багов и внесения обратно совместимых изменений.

		!!! tip


		Обратно несовместимые изменения и новые функции добавляются в "МИНОРНЫЕ" версии.

		!!! tip


		Вам следует добавить тесты для вашего приложения.

		С помощью FastAPI это очень просто (благодаря Starlette), см. документацию: [Testing](../tutorial/testing.md){.internal-link target=_blank}


		Часто добавляются новые функции, регулярно исправляются баги, код продолжает постоянно совершенствоваться.

		По указанным причинам текущие версии до сих пор `0.x.x`. Это говорит о том, что каждая версия может содержать обратно несовместимые изменения, следуя <a href="https://semver.org/" class="external-link" target="_blank">соглашению о Семантическом Версионировании</a>.

🌐 Add Russian translation for docs/ru/docs/deployment/versions.md #4985

🌐 Add Russian translation for docs/ru/docs/deployment/versions.md #4985

Conversation

emp7yhead commented Jun 4, 2022

codecov bot commented Jun 4, 2022 • edited Loading

Codecov Report

github-actions bot commented Jun 4, 2022

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

github-actions bot commented Aug 20, 2022

Xewus left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Xewus Aug 23, 2022 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

github-actions bot commented Aug 24, 2022

emp7yhead commented Aug 24, 2022

Xewus commented Aug 24, 2022

Winand Aug 24, 2022 • edited Loading

Choose a reason for hiding this comment

tiangolo commented Aug 26, 2022

🌐 Add Russian translation for `docs/ru/docs/deployment/versions.md` #4985

🌐 Add Russian translation for `docs/ru/docs/deployment/versions.md` #4985

codecov bot commented Jun 4, 2022 •

edited

Loading

Xewus Aug 23, 2022 •

edited

Loading

Winand Aug 24, 2022 •

edited

Loading