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 Polish translation for docs/pl/docs/features.md #5348

Merged
merged 6 commits into from Jun 22, 2023

Conversation

mbroton
Copy link
Contributor

@mbroton mbroton commented Sep 4, 2022

Relates to #3169

This translates docs/features.md into polish

@codecov
Copy link

codecov bot commented Sep 4, 2022

Codecov Report

Patch and project coverage have no change.

Comparison is base (cf73051) 100.00% compared to head (19724d0) 100.00%.

❗ Current head 19724d0 differs from pull request most recent head 834ad80. Consider uploading reports for the commit 834ad80 to get more accurate results

Additional details and impacted files
@@            Coverage Diff            @@
##            master     #5348   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          540       540           
  Lines        13969     13934   -35     
=========================================
- Hits         13969     13934   -35     

see 4 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

@github-actions
Copy link
Contributor

github-actions bot commented Sep 4, 2022

📝 Docs preview for commit 0b1f548 at: https://63150d6480fe05342d8f1dd3--fastapi.netlify.app

@mbroton mbroton mentioned this pull request Sep 4, 2022
@tiangolo tiangolo added lang-all Translations awaiting-review lang-pl Polish translations labels Sep 8, 2022
docs/pl/docs/features.md Outdated Show resolved Hide resolved
docs/pl/docs/features.md Outdated Show resolved Hide resolved

Wszystko zbudowane jako narzędzia i komponenty wielokrotnego użytku, które można łatwo zintegrować z systemami, magazynami oraz bazami danych - relacyjnymi, NoSQL, itp.

### Dependency Injection
Copy link

Choose a reason for hiding this comment

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

While I agree that the name Dependency Injection is so well known that most likely even non-english speaking programmers are likely to be familiar with it and the feature itself is a key feature of FastAPI, I still think that the term Wstrzykiwanie Zależności should be used here. It's well established in polish literature.

I would suggest going with:

Wstrzykiwanie Zależności (Dependency Injection)

or the other way around:

Dependency Injection (Wstrzykiwanie Zależności)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I was thinking about it for a while, but then I noticed that in some other language versions of documentation it's translated, and in others it's not.
So I've decided to go with the same pattern as in spanish translation, which is using "Dependency Injection" as a header but in the next line is adding title for another occurrence, but with explaination in spanish:
image

My reasoning for it was that "Dependency Injection" is definitely used more often in web development industry than "Wstrzykiwanie Zależności", but anyway, to not leaving it untranslated, I've provided translation for it in the next line.

But I agree with you, I'll go with just "Wstrzykiwanie Zależności" as a header, and english version of it in a tooltip (like on the screenshot, but "reversed").

Let me know if that will be fine.

Copy link

Choose a reason for hiding this comment

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

Yes, I guess that makes sense.

docs/pl/docs/features.md Outdated Show resolved Hide resolved
* Walidacja **złożonych struktur**:
* Wykorzystanie hierarchicznych modeli Pydantic, Pythonowego modułu `typing` zawierającego `List`, `Dict`, itp.
* Walidatory umożliwiają jasne i łatwe definiowanie, sprawdzanie złożonych struktur danych oraz dokumentowanie ich jako JSON Schema.
* Możesz mieć głęboko **zagnieżdżone obiekty JSON** i wszystkie je weryfikować i adnotować.
Copy link

Choose a reason for hiding this comment

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

weryfikować i adnotować

once more you used 'weryfikować' instead of 'walidować' which would be more consistent with the rest of your translation.
'Walidacja' is an actual word in polish, though I agree that using it as a verb (walidować) is not something you see often.

Maybe this should be: 'poddać walidacji'
This way it could be both correct and more pleasant to look at. 🤔

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, I agree that "poddać walidacji" sounds much better, thanks!

@github-actions
Copy link
Contributor

📝 Docs preview for commit 19724d0 at: https://63274c10c2a82150c76298da--fastapi.netlify.app

@mbroton
Copy link
Contributor Author

mbroton commented Sep 18, 2022

I applied the changes, thank you for review @eryknn!

@mbroton
Copy link
Contributor Author

mbroton commented Nov 15, 2022

Hi @eryknn! If everything looks good to you, can you approve this PR?

Copy link

@eryknn eryknn left a comment

Choose a reason for hiding this comment

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

Approving after double checking post-review changes.

@github-actions
Copy link
Contributor

📝 Docs preview for commit 093546d at: https://639cda51e97dd300a9989dbb--fastapi.netlify.app

Mordson

This comment was marked as resolved.

Copy link

@Mordson Mordson left a comment

Choose a reason for hiding this comment

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

After reading previous conversatiom about Polish word "walidować", I can see that it was changed in good place

@tiangolo
Copy link
Owner

📝 Docs preview for commit 834ad80 at: https://64943579681c051e3e29670d--fastapi.netlify.app

@tiangolo
Copy link
Owner

Awesome, thank you @mbroton! 🍰

And thanks for the reviews @Mordson, @Valaraucoo, @eryknn 🙇 ☕

@tiangolo tiangolo merged commit a92e9c9 into tiangolo:master Jun 22, 2023
11 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-pl Polish translations
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants