Codestin Search App

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

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


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

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

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


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

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

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


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

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

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


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

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

+
+Разные версии **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

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


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

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

Это означает

Сие гласит

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

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


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

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

Это означает

Сие гласит

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

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


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

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

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

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


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

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

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

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


увидеть

Посмотреть

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

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


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

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

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

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

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

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

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

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

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

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


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

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

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

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


версии

Й

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

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


Testing

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

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

  - 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

+
+Часто добавляются новые функции, регулярно исправляются баги, код продолжает постоянно совершенствоваться.
+
+По указанным причинам текущие версии до сих пор `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

		@@ -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>.

Uh oh!

Conversation

emp7yhead commented Jun 4, 2022

Uh oh!

codecov Bot commented Jun 4, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

github-actions Bot commented Jun 4, 2022

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Aug 20, 2022

Uh oh!

Xewus left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Xewus Aug 23, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Aug 24, 2022

Uh oh!

emp7yhead commented Aug 24, 2022

Uh oh!

Xewus commented Aug 24, 2022

Uh oh!

Winand Aug 24, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tiangolo commented Aug 26, 2022

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

codecov Bot commented Jun 4, 2022 •

edited

Loading

Xewus Aug 23, 2022 •

edited

Loading

Winand Aug 24, 2022 •

edited

Loading