[pl] docs/contribute/analytics.md #49640
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is the Polish translation.
My remarks:
The English version is the canonical source. It is the source of truth.
I translate everything exactly as it is - every sentence.
I don't add anything, and I don't leave anything out.
This translation is a mirror of the English version in Polish.
This is not a poem :) so it is more important to provide
a good source of translated knowledge than to write in beautiful Polish.
So I translate each English sentence into a Polish sentence:
I keep the original formatting, comments, and everything else to ensure synchronization
by line numbers between the English and Polish files.
It is important to me to create documents that are easy to maintain!
So, Polish documents have all lines in the same places (with the same line numbers)
as in the English version. This makes it very easy to compare, translate, fix,
and maintain the content.
The Polish translation follows the English header ID, so for every header, I explicitly
add the English header ID when it is not explicitly defined. For example, for the English header:
I convert it into Polish:
with header-id
contributing-basics
created base on EnglishContributing basics
.When the English source contains a header with an explicitly set header ID, I simply copy it.
For example, for the English header:
I convert it into Polish:
. So here we have header-id
fork-the-repo
, notwork-from-a-local-fork
.Some English words are so commonly used in the Polish language that it is better
NOT to translate them; otherwise, no Polish IT specialist would understand them :) For example:
I translate it as if it were a Polish word.
When some words might be misunderstood in the Polish translation, I add the original English word
in brackets. For example:
(ang. symbolic link)"
When content refers to something material that contains English words, I keep it as it is.
For example, in a sentence like this:
I keep
**Create an issue**
in its original form, so we have:Some English words are difficult to translate into Polish in the sense that the corresponding
Polish word is very uncommon, is translated into more than one word, or sounds strange. In these cases,
I sometimes translate the same word in different ways. For example:
In these cases, when I am not sure, I add these tricky words or sentences to
the PR description or comments to make the review process easier for reviewers.
As a starting point, I use chat-gpt, and then I read and adjust every sentence to check
and modify/correct it if necessary.
If something is wrong in the English version, for example some diagrams, I copy it as it is.
Once it is corrected in the English version, I correct it in the Polish version.