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

New Polish Translation Progress #287

Open
jakubdrozdek opened this issue Nov 29, 2021 · 27 comments
Open

New Polish Translation Progress #287

jakubdrozdek opened this issue Nov 29, 2021 · 27 comments
Assignees
Labels

Comments

@jakubdrozdek
Copy link
Member

jakubdrozdek commented Nov 29, 2021

New Site Translation Progress

Maintainer List

Retired maintainers

Preview

https://pl.react.dev/

Original issue

This issue was based on: reactjs/react.dev#4135

How to translate

If you want to help with translation, please leave a comment in this issue and write the name of the page you would like to translate. One of the repo maintainers will add your GitHub nickname next to the page to "make a reservation".

Main Content

To do before releasing as an "official" translation. Please translate these pages first.

Note that each section has an index page, which needs to be translated too.

Learn React

API Reference

  • react: Hooks

  • react: Components

    • <Fragment> (<>)
    • <Profiler>
    • <StrictMode>
    • <Suspense>
  • react: APIs

    • createContext
    • forwardRef
    • lazy
    • memo
    • startTransition
  • react-dom: Components

    • Common (e.g. <div>)
    • <input>
    • <option>
    • <progress>
    • <select>
    • <textarea>
  • react-dom: APIs

    • createPortal
    • flushSync
    • findDOMNode
    • hydrate
    • render
    • unmountComponentAtNode
  • react-dom/client: Client APIs

    • createRoot
    • hydrateRoot
  • react-dom/server: Server APIs

    • renderToNodeStream
    • renderToPipeableStream
    • renderToReadableStream
    • renderToStaticMarkup
    • renderToStaticNodeStream
    • renderToString

Navigation and UI

We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.

  • Homepage (currently in HomeContent.js)
  • Sidebars (currently in src/sidebar*.json)
  • Top-level navigation (currently in TopNav.tsx)

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.

Secondary Content

These API pages should ideally be translated too, but they're less urgent and can be done after the others:

  • Legacy React APIs
    • Children
    • cloneElement
    • Component
    • createElement
    • createFactory
    • createRef
    • isValidElement
    • PureComponent

Optional Content

These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:

  • Community
  • Blog
  • Warnings
@lukbar48
Copy link
Contributor

I will take Conditional rendering

@cyntler
Copy link
Contributor

cyntler commented May 23, 2022

@lukbar48 do you do something with Rendering Lists?

@cyntler
Copy link
Contributor

cyntler commented May 23, 2022

@jakubdrozdek I can take Keeping Components Pure. Could you assign it to me?
Ok, as @lukbar48 mentioned below, assign also Rendering Lists to me please.

@lukbar48
Copy link
Contributor

@lukbar48 do you do something with Rendering Lists?

no, take it

@gaearon
Copy link
Member

gaearon commented Apr 20, 2023

Hi folks,

Just a heads-up that we've done our best to bring main and legacy branches up-to-date with upstream. This brings you to the latest visual design and sets up all the redirects. We don't anticipate more changes necessary on legacy. For main, there's a few things you need to be aware of:

  • Keep in mind translating UI is best done closer to the end. We plan to make non-trivial code changes to the repo over the next few months. So it's best to focus on the content rather than on UI components.
  • The homepage is untranslated so ideally it would be good if you could do a pass at that. For now, unfortunately it requires messing with the code file.
  • A few rewritten pages (from Installation) are currently untranslated.
  • This was a massive PR to merge, so we might have regressed somewhere or missed some changes that needed to be translated. Ideally, it would be great if you could go over the already-translated pages at your own pace and verify nothing important got lost.

Thank you so much for your cooperation!

@jakubdrozdek
Copy link
Member Author

Hey @gaearon , I'll take a look at this soon and try to update our translations for the new docs. Thanks for resolving all conflicts. I saw how big and complex they were. I'm glad you did this for us 😅

@gaearon
Copy link
Member

gaearon commented Apr 21, 2023

Ah this wasn't me, that's all @rickhanlonii's doing :)

@gaearon
Copy link
Member

gaearon commented Apr 25, 2023

I've updated this issue's TODO list to the current template.

@gaearon gaearon changed the title Beta - Polish Translation Progress New Polish Translation Progress Apr 25, 2023
@aadamw
Copy link

aadamw commented Apr 28, 2023

Hey, I could pick up the "Start a New React Project"

@dawidsabat
Copy link
Contributor

Hi @jakubdrozdek, I would like to contribute a bit. I can start with useCallback.

@dawidsabat
Copy link
Contributor

PR for useCallback is ready. I would like to start with useEffect now.

@dawidsabat
Copy link
Contributor

I would like to translate "Start a New React Project" section.

@dawidsabat
Copy link
Contributor

I would like to take "Rendering Lists" from "Describing the UI".

@tomaszwysocki
Copy link
Contributor

I would like to translate "Add React to an Existing Project" page.

@dawidsabat
Copy link
Contributor

@jakubdrozdek, I would like to. take now Keeping Components Pure .

Two PRs already wait for for next comments or approval ;)
#444 - Start a New React Project
#460 - Rendering Lists

@dawidsabat
Copy link
Contributor

I would like to take Render and Commit page - need something light now ;)

@wizarddos
Copy link

Can I pick up Add react to an existing project page?

@tomaszwysocki
Copy link
Contributor

@wizarddos I was doing that. It has been pushed already.

@wizarddos
Copy link

@tomaszwysocki Oh, all right

@dawidsabat
Copy link
Contributor

I would like to Adding Interactivity now.

@dawidsabat
Copy link
Contributor

PR for Adding Interactivity is ready under #478.
I would like to translate Preserving and Reseting State now.

Moreover, I see Add React to an Existing Project is already translated by @tomaszwysocki but not marked as done in the checklist. @jakubdrozdek, could you update it? ;)

@JohnyKam
Copy link

Hi. I would like to translate Tutorial: Tic Tac Toe page. I hope that I will handle it. :-)

@wizarddos
Copy link

Can I take Responding to Events or State: A Component's Memory ?

@dawidsabat
Copy link
Contributor

@JohnyKam and @wizarddos, welcome aboard! Good to see we have more contributors! 😄

Basically, you can take whatever is not taken yet. Posting here what you want to translate is enough.
Take a look into PL Consultations and TRANSLATIONS.md to follow patterns and glossary. Feel free to propose new translations!

@JohnyKam, I would recommend to start with some shorter page. Tutorial: Tic Tac Toe is quite big page to start with.
But if you fill you will handle it, go for it 😃

By the way, @jakubdrozdek, I have recently changed my nickname from @Dawidowski to @dawidsabat. Could I ask you to change it as well in the starting post above? I would love to do it myself but you are the author of this post

@JohnyKam
Copy link

JohnyKam commented Oct 6, 2024

True, Tutorial: Tic Tac Toe is quite big. Can I start with Sharing State Between Components? Then, if necessary, I will move on to Tutorial: Tic Tac Toe :-).

@dawidsabat
Copy link
Contributor

@JohnyKam, go for it! 😀

@dawidsabat
Copy link
Contributor

I would like to translate State as a Snapshot now.

@jakubdrozdek, @wizarddos - PR #490 for Preserving and Resetting State is ready for the review. I would love to hear your feedback 😉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

9 participants