puter icon indicating copy to clipboard operation
puter copied to clipboard

Translate README.md from English to Polish

Open jelveh opened this issue 1 year ago • 3 comments

We need to create a Polish version of our README to make our project more accessible to Polish-speaking users and contributors.

Task Description

  • Translate the content of ./doc/i18n/README.en.md to Polish
  • Create a new file ./doc/i18n/README.pl.md with the translated content
  • Ensure the format and styling of the original English README is preserved exactly in the Polish version

Steps

  1. Copy the existing README.en.md file to create README.pl.md in the same directory (./doc/i18n/)
  2. Translate all text content from English to Polish, including:
    • Headings
    • Paragraphs
    • Lists
    • Code comments (if any)
    • Any other textual content
  3. Preserve all markdown formatting, including:
    • Heading levels
    • Bold and italic text
    • Links
    • Code blocks
    • Tables
    • Images
  4. Ensure all links and references remain functional in the Polish version
  5. Update any language-specific content (e.g., language badges) to reflect Polish instead of English

Additional Considerations

  • Maintain consistent terminology throughout the translation
  • Pay attention to technical terms that may have specific translations or may need to remain in English
  • If there are any culture-specific examples or references, consider adapting them for a Polish-speaking audience if appropriate

Definition of Done

  • [ ] README.pl.md file created in ./doc/i18n/ directory
  • [ ] All content accurately translated to Polish
  • [ ] Format and styling match the original English version exactly
  • [ ] All links and references are functional
  • [ ] Translation reviewed by a native Polish speaker (if possible)
  • [ ] Update project documentation or configuration to include the new Polish README (if necessary)

Resources

  • Original English README: ./doc/i18n/README.en.md
  • GitHub Markdown Guide for reference on markdown syntax

jelveh avatar Aug 15 '24 00:08 jelveh

I would like to work on this issue. Can You please assign this issue to me.

VinayakPaka avatar Aug 15 '24 11:08 VinayakPaka

Hi @VinayakPaka, thank you for your interest in contributing to Puter. Quick question, since you've asked to be assigned to multiple translation issues, do you speak all these languages? If not, could you please start with languages that you are fluent in?

Thanks again.

jelveh avatar Aug 15 '24 15:08 jelveh

Hi !, @jelveh I have raised a PR. Please review to and merge it.

Thank you.

VinayakPaka avatar Aug 26 '24 09:08 VinayakPaka

Hi! @jelveh I saw there's an open/merged PR for translating the README into Polish.

I’d love to contribute by translating it into Hindi, to make it accessible to a broader audience in India.

Would you be open to a Hindi translation as well? If yes, I can get started right away!

Rohanpawar9921 avatar Jun 15 '25 08:06 Rohanpawar9921

Hi @Rohanpawar9921,

Thank you for your offer to contribute to Puter. We currently have a Hindi translation of Puter's README.md (link); however, if you think it needs improvements, feel free to create a PR for it, I'd be happy to review and merge.

Nariman

jelveh avatar Jun 16 '25 21:06 jelveh

Hi @jelveh ,

Thanks for your response! šŸ™

I went ahead and made the improvements to the Hindi translation of the README. You can review the PR here: https://github.com/HeyPuter/puter/pull/1311

Looking forward to your feedback 😊

— Rohan

Rohanpawar9921 avatar Jun 18 '25 05:06 Rohanpawar9921