Skip to content

New Azerbaijani Translation Progress #376

Open
Open
New Azerbaijani Translation Progress#376

Description

@gaearon
gaearon
opened on Apr 25, 2023

Maintainer List

For New Translators

To translate a page:

  1. Check that no one else has claimed your page in the checklist and comments below.
  2. Comment below with the name of the page you would like to translate. Please take only one page at a time.
  3. Clone this repo, translate your page, and submit a pull request!

Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.

Please be prompt with your translations! If you find that you can't commit anymore, let the maintainers know so they can assign the page to someone else.

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

When PRs are merged, make sure to mark that page as completed!

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

  • Quick Start (@vugartaghiyev)

  • Installation (@nasirmovlamov)

    • Start a New React Project (@nasirmovlamov)
    • Add React to an Existing Project
    • Editor Setup
    • React Developer Tools

  • Describing the UI

    • Your First Component
    • Importing and Exporting Components
    • Writing Markup with JSX
    • JavaScript in JSX with Curly Braces
    • Passing Props to a Component
    • Conditional Rendering
    • Rendering Lists
    • Keeping Components Pure

  • Adding Interactivity

    • Responding to Events
    • State: A Component's Memory
    • Render and Commit
    • State as a Snapshot
    • Queueing a Series of State Updates
    • Updating Objects in State
    • Updating Arrays in State

  • Managing State

    • Reacting to Input with State
    • Choosing the State Structure
    • Sharing State Between Components
    • Preserving and Resetting State
    • Extracting State Logic into a Reducer
    • Passing Data Deeply with Context
    • Scaling Up with Reducer and Context

  • Escape Hatches

    • Referencing Values with Refs
    • Manipulating the DOM with Refs
    • Synchronizing with Effects
    • You Might Not Need an Effect
    • Lifecycle of Reactive Effects
    • Separating Events from Effects
    • Removing Effect Dependencies
    • Reusing Logic with Custom Hooks

API Reference

  • react: Hooks

    • useCallback
    • useContext
    • useDebugValue
    • useDeferredValue
    • useEffect
    • useId
    • useImperativeHandle
    • useInsertionEffect
    • useLayoutEffect
    • useMemo
    • useReducer
    • useRef
    • useState
    • useSyncExternalStore
    • useTransition

  • 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) (@nasirmovlamov )
  • Sidebars (currently in src/sidebar*.json) (@nasirmovlamov )
  • Top-level navigation (currently in TopNav.tsx) (@nasirmovlamov )

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

Activity

  1. gaearon
    pinned this issue on Apr 25, 2023

  2. nasirmwl commented on Apr 25, 2023

    @nasirmwl
    nasirmwl
    on Apr 25, 2023
    Collaborator

    I have taken Learn React

  3. gaearon commented on Apr 25, 2023

    @gaearon
    gaearon
    on Apr 25, 2023
    MemberAuthor

    @GasimGasimzada @azizaismayilova

    Could you please confirm whether you would be able to maintain and steer this translation effort? If not, please send a PR to remove yourself from https://github.com/reactjs/translations.react.dev/blob/main/langs/az.json — then we'd need to find new maintainers before proceeding. Thank you!

  4. nasirmwl commented on Apr 25, 2023

    @nasirmwl
    nasirmwl
    on Apr 25, 2023
    Collaborator

    @gaearon In case of not getting info from them, i would like to participate during translation as a maintainer.

  5. gaearon commented on Apr 25, 2023

    @gaearon
    gaearon
    on Apr 25, 2023
    MemberAuthor

    Sounds good — let’s give them some time to respond. Thanks!

  6. GasimGasimzada commented on Apr 25, 2023

    @GasimGasimzada
    GasimGasimzada
    on Apr 25, 2023
    Collaborator

    Hi @gaearon, I can spend time on maintaining the repo and helping with translations; however, at a limited capacity in comparison to the first time I did the translations.

  7. GasimGasimzada commented on Apr 26, 2023

    @GasimGasimzada
    GasimGasimzada
    on Apr 26, 2023
    Collaborator

    Hi again, @gaearon. I am trying to form a team of contributors to help with the translation. Can you please tell me how to add new people as contributors? I will add them in the repo myself (I think I still have admin rights) but not sure if any other place needs to be updated. @nasirmovlamov and @wamujlb are currently two people who are interested. I am also in contact with others.

  8. azizaismayilova commented on Apr 26, 2023

    @azizaismayilova
    azizaismayilova
    on Apr 26, 2023
    Contributor

    Hi @gaearon! I will work on this translation as well. Also, I am happy to review/edit others pr to help them with proofreading.

  9. gaearon commented on Apr 26, 2023

    @gaearon
    gaearon
    on Apr 26, 2023
    MemberAuthor

    @GasimGasimzada Please send a PR to edit https://github.com/reactjs/translations.react.dev/blob/main/langs/az.json. I will fix it so that it gets synced later today.

  10. vugartaghiyev commented on Apr 26, 2023

    @vugartaghiyev
    vugartaghiyev
    on Apr 26, 2023

    Hi, I also want to help with the translation.

  11. nasirmwl commented on Apr 26, 2023

    @nasirmwl
    nasirmwl
    on Apr 26, 2023
    Collaborator

    I have taken Homepage and TopNav, I made pr for them, but I will fix based on our previous dictionary and commit again with fixes. fyi @GasimGasimzada @azizaismayilova

  12. nasirmwl commented on Apr 28, 2023

    @nasirmwl
    nasirmwl
    on Apr 28, 2023
    Collaborator

    I have taken Sidebars

  13. azizaismayilova commented on Apr 28, 2023

    @azizaismayilova
    azizaismayilova
    on Apr 28, 2023
    Contributor

    Hi @nasirmovlamov ! Could you please start translating content in recommended order? As it is mentioned above Navigation and UI content will need some invasive changes.

  14. azizaismayilova commented on Apr 28, 2023

    @azizaismayilova
    azizaismayilova
    on Apr 28, 2023
    Contributor

    Hi @vugartaghiyev ! Can you please select the content that you want to work one (preferably in recommended section) and comment it here? İ will add your name to the selected content until @GasimGasimzada will add all of you to the maintainer list.

  15. vugartaghiyev commented on Apr 28, 2023

    @vugartaghiyev
    vugartaghiyev
    on Apr 28, 2023

    Hi @azizaismayilova, I will take Quick Start Is that ok?

  16. 1 remaining item

  17. GasimGasimzada commented on Apr 29, 2023

    @GasimGasimzada
    GasimGasimzada
    on Apr 29, 2023
    Collaborator

    @vugartaghiyev @nasirmovlamov @wamujlb please join the Discord to discuss some specific translation topics: https://discord.gg/9ugVdPuf

  18. gaearon commented on Apr 29, 2023

    @gaearon
    gaearon
    on Apr 29, 2023
    MemberAuthor

    Can you please tell me how to add new people as contributors? I will add them in the repo myself (I think I still have admin rights) but not sure if any other place needs to be updated.

    I’ve changed how this works yesterday — basically just add people in Settings as admins to the repo.

  19. GasimGasimzada commented on Apr 29, 2023

    @GasimGasimzada
    GasimGasimzada
    on Apr 29, 2023
    Collaborator

    awesome will do thank!

  20. nasirmwl commented on May 1, 2023

    @nasirmwl
    nasirmwl
    on May 1, 2023
    Collaborator

    I have taken Installation fyi

  21. GasimGasimzada commented on May 1, 2023

    @GasimGasimzada
    GasimGasimzada
    on May 1, 2023
    Collaborator

    Okay, I added your name near Installation and gave you write access.

  22. nasirmwl commented on May 10, 2023

    @nasirmwl
    nasirmwl
    on May 10, 2023
    Collaborator

    Hello, please check new pr Installation and i want to take Start a New React Project

  23. GasimGasimzada commented on May 10, 2023

    @GasimGasimzada
    GasimGasimzada
    on May 10, 2023
    Collaborator

    @nasirmovlamov You can pick it up while we review it in parallel. For the future, when you want to pick up a new page, edit the issue and tag your username next to the page name.

  24. nasirmwl commented on May 11, 2023

    @nasirmwl
    nasirmwl
    on May 11, 2023
    Collaborator

    Sure 👍

  25. Vug6r commented on Aug 2, 2023

    @Vug6r
    Vug6r
    on Aug 2, 2023

    Hey! I would like to take Describing the UI

  26. nasirmwl commented on Aug 3, 2023

    @nasirmwl
    nasirmwl
    on Aug 3, 2023
    Collaborator

    Sure go ahead @Vug6r

  27. exrem commented on Mar 4, 2024

    @exrem
    exrem
    on Mar 4, 2024

    hello! quick start seems taken but hasn't been translated yet, so, i'd like to take it ^^

  28. rarblack commented on Jun 26, 2024

    @rarblack
    rarblack
    on Jun 26, 2024

    I do not see any progress on translation. Is this thread dead?

  29. rarblack commented on Jun 27, 2024

    @rarblack
    rarblack
    on Jun 27, 2024

    @gaearon if this thread still valid can you add me to the maintainer list. The progress here is going less than slow.

  30. GasimGasimzada commented on Jul 4, 2024

    @GasimGasimzada
    GasimGasimzada
    on Jul 4, 2024
    Collaborator

    @rarblack added you to maintainers list. Let me know which page you want to pick up.

  31. rashadqarayev commented on Mar 19, 2026

    @rashadqarayev
    rashadqarayev
    on Mar 19, 2026

    Hello, i want to join as a contrubuter. I am also author of Javascript book.Can you get in touch with me?
    @gaearon

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions