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

[pl] docs/contribute/analytics.md #49640

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

dkarczmarski
Copy link
Contributor

This is the Polish translation.

My remarks:

  1. The English version is the canonical source. It is the source of truth.

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

  3. 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 don’t merge sentences.
    • I don’t split sentences.
    • I don’t change the order of sentences.
  4. I keep the original formatting, comments, and everything else to ensure synchronization
    by line numbers between the English and Polish files.

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

  6. 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:

    ## Contributing basics
    

    I convert it into Polish:

    ## Podstawy kontrybucji {#contributing-basics}
    

    with header-id contributing-basics created base on English Contributing basics.

    When the English source contains a header with an explicitly set header ID, I simply copy it.
    For example, for the English header:

    ## Work from a local fork {#fork-the-repo}
    

    I convert it into Polish:

    ## Praca z lokalną kopią {#fork-the-repo}
    

    . So here we have header-id fork-the-repo, not work-from-a-local-fork.

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

    • pull request
    • commit
    • deploy
    • fork
      I translate it as if it were a Polish word.
  8. When some words might be misunderstood in the Polish translation, I add the original English word
    in brackets. For example:

    • "you must also create a symbolic link" to "musisz również utworzyć dowiązanie symboliczne
      (ang. symbolic link)"
    • "you need to switch the upstream branch" to "musisz przełączyć gałąź (ang. upstream branch)"
  9. When content refers to something material that contains English words, I keep it as it is.
    For example, in a sentence like this:

    1. Click the **Create an issue** link on the right sidebar. This redirects you
    

    I keep **Create an issue** in its original form, so we have:

    1. Kliknij link **Create an issue** na prawym pasku bocznym. Przekieruje Cię  
    
  10. 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:

    • "contribution / to contribute" into:
      • "wkład / wnosić wkład / robić wkład"
      • "robić kontrybucje"
      • "kontrybucja"
      • "przyczyniać się"
    • "to localize / localizing" into:
      • "lokalizować"
      • "regionalizować"
      • "tłumaczenie i adaptacja językowa"
    • "content" into:
      • "treść"
      • "zawartość"

    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.

  11. As a starting point, I use chat-gpt, and then I read and adjust every sentence to check
    and modify/correct it if necessary.

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

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. area/localization General issues or PRs related to localization language/pl Issues or PRs related to Polish language sig/docs Categorizes an issue or PR as relevant to SIG Docs. labels Feb 4, 2025
@k8s-ci-robot k8s-ci-robot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Feb 4, 2025
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign mfilocha for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Copy link

netlify bot commented Feb 4, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit d329c7f
🔍 Latest deploy log https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/67a227a6efa80e00083db5f2
😎 Deploy Preview https://deploy-preview-49640--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/pl Issues or PRs related to Polish language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants