Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

🌐 Add Ukrainian translation for docs/uk/docs/alternatives.md #10060

Conversation

whysage
Copy link
Contributor

@whysage whysage commented Aug 11, 2023

No description provided.

@whysage whysage changed the title added translates for fastapi alternatives page Doc - Ukrainian translation for fastapi alternatives page Aug 11, 2023

Вони більш-менш знаходяться на протилежних кінцях, доповнюючи одна одну.

Requests мають дуже простий та інтуїтивно зрозумілий дизайн, дуже простий у використанні, з розумними параметрами за замовчуванням. Але в той же час він дуже потужний і настроюється.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Requests мають дуже простий та інтуїтивно зрозумілий дизайн, дуже простий у використанні, з розумними параметрами за замовчуванням. Але в той же час він дуже потужний і настроюється.
Requests мають дуже простий та інтуїтивно зрозумілий дизайн, дуже простий у використанні, з розумними параметрами за замовчуванням. Але в той же час він дуже потужний і налаштовується.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, updated

@tiangolo
Copy link
Owner

📝 Docs preview for commit 308887e at: https://638aff5e.fastapitiangolo.pages.dev

@whysage
Copy link
Contributor Author

whysage commented Aug 12, 2023

@tiangolo tiangolo changed the title Doc - Ukrainian translation for fastapi alternatives page 🌐 Add Ukrainian translation for docs/uk/docs/alternatives.md Aug 14, 2023
@tiangolo tiangolo added lang-all Translations awaiting-review lang-uk Ukrainian translations labels Aug 14, 2023
Copy link

@romashevchenko romashevchenko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi there! I'm a native speaker and a part of DreamProIT team. I have reviewed this translation and added some improvements.

@@ -0,0 +1,412 @@
# Альтернативи, натхнення та порівняння

Що надихнуло **FastAPI**, як він порівнюється з іншими альтернативами та чого він у них навчився.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Що надихнуло **FastAPI**, як він порівнюється з іншими альтернативами та чого він у них навчився.
Що надихнуло на створення **FastAPI**, який він у порінянні з іншими альтернативами та чого він у них навчився.


### <a href="https://www.django-rest-framework.org/" class="external-link" target="_blank">Django REST Framework</a>

Інфраструктура Django REST була створена як гнучкий інструментарій для створення веб-інтерфейсів API за допомогою Django під ним, щоб покращити його можливості API.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Інфраструктура Django REST була створена як гнучкий інструментарій для створення веб-інтерфейсів API за допомогою Django під ним, щоб покращити його можливості API.
Фреймворк Django REST був створений як гнучкий інструментарій для створення веб-інтерфейсів API використовуючи Django в основі, щоб покращити його можливості API.

Django REST Framework створив Том Крісті. Той самий творець Starlette і Uvicorn, на яких базується **FastAPI**.


!!! Переглянте "Надихнуло **FastAPI** на"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
!!! Переглянте "Надихнуло **FastAPI** на"
!!! Перегляньте "Надихнуло **FastAPI** на"


Ця простота та гнучкість дозволяють використовувати бази даних NoSQL як основну систему зберігання даних.

Оскільки він дуже простий, його відносно інтуїтивно зрозуміло освоїти, хоча в деяких моментах документація стає дещо технічною.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Оскільки він дуже простий, його відносно інтуїтивно зрозуміло освоїти, хоча в деяких моментах документація стає дещо технічною.
Оскільки він дуже простий, він порівняно легкий та інтуїтивний для освоєння, хоча в деяких моментах документація стає дещо технічною.


Він також зазвичай використовується для інших програм, яким не обов’язково потрібна база даних, керування користувачами або будь-яка з багатьох функцій, які є попередньо вбудованими в Django. Хоча багато з цих функцій можна додати за допомогою плагінів.

Ключовою особливістю, яку я хотів зберегти, було відокремлення частин і бути «мікрофреймворком», який можна було розширити, щоб охопити саме те, що потрібно.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Ключовою особливістю, яку я хотів зберегти, було відокремлення частин і бути «мікрофреймворком», який можна було розширити, щоб охопити саме те, що потрібно.
Відокремлення частин було ключовою особливістю, яку я хотів зберегти, при цьому залишаючись «мікрофреймворком», який можна розширити, щоб охопити саме те, що потрібно.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please double check here. I do not like sentence start like "Це відокремлення частин" we do not have ref for "Це" in prev sentence.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The original text has "this" in the sentence, which refers to the ability to add features by adding plug-ins mentioned in the previous two sentences, as far as I've understood the context. Yet, it can be omitted in the translation, that's true.
"This decoupling of parts, and being a "microframework" that could be extended to cover exactly what is needed was a key feature that I wanted to keep."

* Події запуску та завершення роботи.
* Тестовий клієнт, побудований на HTTPX.
* CORS, GZip, статичні файли, потокові відповіді.
* Підтримка сеансів і файлів cookie.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Підтримка сеансів і файлів cookie.
* Підтримку сеансів і файлів cookie.

* CORS, GZip, статичні файли, потокові відповіді.
* Підтримка сеансів і файлів cookie.
* 100% покриття тестом.
* 100% анотована кодова база.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* 100% анотована кодова база.
* 100% анотовану кодову базу.


Тим не менш, він уже використовується як «стандарт» кількома інструментами. Це значно покращує сумісність, оскільки ви можете переключити Uvicorn на будь-який інший сервер ASGI (наприклад, Daphne або Hypercorn), або ви можете додати інструменти, сумісні з ASGI, як-от `python-socketio`.

!!! Переглянте "**FastAPI** використовує його для"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
!!! Переглянте "**FastAPI** використовує його для"
!!! Перегляньте "**FastAPI** використовує його для"


Uvicorn — це блискавичний сервер ASGI, побудований на uvloop і httptools.

Це не веб-фреймворк, а сервер. Наприклад, він не надає інструментів для маршрутизації. Це те, що фреймворк на кшталт Starlette (або **FastAPI**) забезпечить на поверх нього.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Це не веб-фреймворк, а сервер. Наприклад, він не надає інструментів для маршрутизації. Це те, що фреймворк на кшталт Starlette (або **FastAPI**) забезпечить на поверх нього.
Це не веб-фреймворк, а сервер. Наприклад, він не надає інструментів для маршрутизації. Це те, що фреймворк на кшталт Starlette (або **FastAPI**) забезпечить поверх нього.


Це рекомендований сервер для Starlette і **FastAPI**.

!!! Переглянте "**FastAPI** рекомендує це як"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
!!! Переглянте "**FastAPI** рекомендує це як"
!!! Перегляньте "**FastAPI** рекомендує це як"

romashevchenko

This comment was marked as duplicate.

@whysage
Copy link
Contributor Author

whysage commented Aug 14, 2023

@romashevchenko thanks for the great review!
I updated all items exept

Ключовою особливістю, яку я хотів зберегти, було відокремлення частин і бути «мікрофреймворком», який можна було розширити, щоб охопити саме те, що потрібно.
->
Це відокремлення частин, при цьому залишаючись «мікрофреймворком», який можна розширити, щоб охопити саме те, що потрібно, було ключовою особливістю, яку я хотів зберегти.

please recheck this item.

@tiangolo
Copy link
Owner

📝 Docs preview for commit 6929e28 at: https://da63d4f4.fastapitiangolo.pages.dev

@whysage
Copy link
Contributor Author

whysage commented Aug 14, 2023

📝 Docs preview for commit 6929e28 at: https://da63d4f4.fastapitiangolo.pages.dev

I added one more commit with updates after 6929e28.

@tiangolo
Copy link
Owner

📝 Docs preview for commit 50004db at: https://313f3dc3.fastapitiangolo.pages.dev

@rostik1410
Copy link
Contributor

@tiangolo Hey, could you merge this PR pls, @whysage changed everything that was requested and has 2 required approvals, thanks

@whysage
Copy link
Contributor Author

whysage commented Aug 26, 2023

@romashevchenko I updated your last comment, due to removing word "Це" from it.
c7ee461

@tiangolo
Copy link
Owner

📝 Docs preview for commit c7ee461 at: https://f655be0d.fastapitiangolo.pages.dev


Він також зазвичай використовується для інших програм, яким не обов’язково потрібна база даних, керування користувачами або будь-яка з багатьох функцій, які є попередньо вбудованими в Django. Хоча багато з цих функцій можна додати за допомогою плагінів.

Ключовою особливістю, яку я хотів зберегти, було відокремлення частин і бути «мікрофреймворком», який можна було розширити, щоб охопити саме те, що потрібно.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The original text has "this" in the sentence, which refers to the ability to add features by adding plug-ins mentioned in the previous two sentences, as far as I've understood the context. Yet, it can be omitted in the translation, that's true.
"This decoupling of parts, and being a "microframework" that could be extended to cover exactly what is needed was a key feature that I wanted to keep."

@tiangolo
Copy link
Owner

tiangolo commented Sep 2, 2023

Thanks @whysage! 🎉

And thanks for the reviews @rostik1410, @mezgoodle, @romashevchenko 🕺

@tiangolo tiangolo merged commit ad76dd1 into tiangolo:master Sep 2, 2023
36 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved-2 lang-all Translations lang-uk Ukrainian translations
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants