fa.react.dev icon indicating copy to clipboard operation
fa.react.dev copied to clipboard

Published 20 hours ago • verified publisher icon reactjs

Persian Translation Progress

Open tesseralis opened this issue 5 years ago • 250 comments

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. Take only one page at a time.
  3. Clone this repo, make your translations locally, 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.

Core Pages

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

  • [x] Home Page (@sorousht)
  • [ ] Tutorial(@amir28)

Basics

  • [x] Hello World (@sorousht) #38
  • [x] Introducing JSX (@hosseinAMD) #166
  • [x] Rendering Elements (@sorousht) #28
  • [x] Components and Props (@mohsenkhanpour) #46
  • [x] State and Lifecycle (@sorousht) #32
  • [x] Handling Events (@hosseinAMD) #173
  • [x] Conditional Rendering (@black-sheep777, @sorousht) #47 #64
  • [x] Lists and Keys (@zahrajoulaei) #36
  • [x] Forms (@mjraadi) #33
  • [x] Lifting State Up (@Abolfazl2647) #125
  • [x] Composition vs Inheritance (@sorousht) #110
  • [x] Thinking in React (@rfnmt) #122

API Reference

  • [x] React (@mahdinba97)
  • [x] React.Component (@hosseinAMD) #158
  • [x] ReactDOM (@Abolfazl2647) #126
  • [x] ReactDOMServer (@seven-deuce) #58
  • [x] DOM Elements (@x1smind, @sorousht) #59 #152
  • [x] SyntheticEvent (@seven-deuce) #63 #67
  • [x] Test Utilities (@hosseinAMD) #156
  • [x] Shallow Renderer (@seven-deuce) #69
  • [x] Test Renderer (@hosseinAMD) #162
  • [x] JS Environment Requirements (@pooya-alen1990)
  • [x] Glossary (@Abolfazl2647 ) #138

Navigation

These are the navigation links that appear in the sidebar. Possibly wait until the corresponding sections are translated to do these.

  • [ ] tutorial/nav.yml
  • [ ] docs/nav.yml

Next Steps

These are the next most important translations, ordered by importance:

Installation

  • [ ] Getting Started (@novonimo)
  • [ ] Add React to a Website (@RezaImany)
  • [ ] Create a New React App (@nodehi78)
  • [ ] CDN Links (@hosseinmp76)

Hooks

Everyone is hooked on hooks! People are really excited about these and it would be great for them to be translated.

  • [x] Introducing Hooks (@c0m1t, @sorousht) #11 #12 #26
  • [ ] Hooks at a Glance (@Kosarh79 )
  • [x] Using the State Hook (@J3brahimi) #56
  • [x] Using the Effect Hook (@Abolfazl2647 ) #135
  • [x] Rules of Hooks (@Abolfazl2647) #133
  • [x] Building Your Own Hooks (@Abolfazl2647 ) #134
  • [x] Hooks API Reference (@seven-deuce) #53
  • [ ] Hooks FAQ (@itours-company)

Warnings

These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.

  • [X] dont-call-proptypes (@Shahrzad-gh)
  • [ ] invalid-aria-prop
  • [ ] invalid-hook-call-warning
  • [ ] legacy-factories
  • [ ] refs-must-have-owner
  • [ ] special-props
  • [ ] unknown-prop

Advanced Guides

  • [ ] Accessibility (@hamid)
  • [x] Code-Splitting (@pouyajabbarisani, @sorousht) #96 #154
  • [x] Context (@hajarsadeghi) #142
  • [ ] Error Boundaries (@mehdifilban)
  • [x] Forwarding Refs (@hosseinAMD) #150
  • [ ] Fragments (@Pedroxam)
  • [ ] Higher-Order Components (@Mrezagolbaba)
  • [ ] Integrating with Other Libraries (@hosseinAMD)
  • [ ] JSX In Depth (@negarelixir)
  • [ ] Optimizing Performance
  • [ ] Portals (@hossein-2)
  • [x] React Without ES6 (@hosseinAMD) #179
  • [x] React Without JSX (@behzad-dev) #200
  • [X] Reconciliation (@MehdiSaraie)
  • [ ] Refs and the DOM (@black-sheep777)
  • [ ] Render Props
  • [ ] Static Type Checking (@ariannargesi)
  • [ ] Strict Mode (@Ali-Parandeh)
  • [ ] Typechecking With PropTypes (@FarzamSeyedhashem)
  • [x] Uncontrolled Components (@imantahriri) #192
  • [ ] Web Components (@najmieh)

FAQ

  • [x] APIs and AJAX (@hosseinAMD) #153
  • [ ] Babel, JSX, and Build Steps
  • [ ] Passing Functions to Components
  • [ ] Component State (@EsmaeilSaleh)
  • [x] Styling and CSS (@sadeghbarati) #145
  • [ ] File Structure
  • [ ] Versioning Policy
  • [ ] Virtual DOM and Internals

Contributing

Priority: Low

  • [ ] How to Contribute
  • [ ] Codebase Overview
  • [ ] Implementation Notes
  • [ ] Design Principles

Components

Components in src/components that have some text in them.

  • [ ] CodeEditor
  • [ ] CodeExample (@SebghatYusuf)
  • [ ] ErrorDecoder
  • [ ] LayoutFooter
  • [ ] LayoutHeader
  • [ ] MarkdownPage

Additional Translations

These are not the primary translation targets.

  • [ ] Blog
  • [ ] Community

tesseralis avatar Feb 09 '19 20:02 tesseralis

started: Hello World

Schabaani avatar Feb 11 '19 16:02 Schabaani

Introducing Hooks #7

c0m1t avatar Feb 11 '19 20:02 c0m1t

Tutorial page is in my WIP

masoud-bahrami avatar Feb 11 '19 20:02 masoud-bahrami

Hello, I want to contribute; Which page is better to start?

Mhmdrza avatar Feb 24 '19 08:02 Mhmdrza

Hey @Mhmdrza, It's preferred to start with Core Pages -> Basics, especially with the written order. eg. Introducing JSX, Rendering Elements and Components and Props.

sorousht avatar Feb 24 '19 09:02 sorousht

I'm on "Introducing JSX"

Mhmdrza avatar Feb 24 '19 09:02 Mhmdrza

I want to work on 'Conditional Rendering', Is that ok? Am I authorized? :)

blacksheepIV avatar Mar 04 '19 08:03 blacksheepIV

Hi @black-sheep777 Absolutely! I assigned it to you :)

sorousht avatar Mar 04 '19 10:03 sorousht

دوستان سلام با تشکر از contribution هاتون خیلی عالیه که این پروژه وجود داره

Suggestion for having a more organised repository and to make it easier to keep track of the progress and remaining tasks:

I can:

  • Create a new issue for each page of the documentation. (i.e. Hello World, Introducing JSX, etc.)
  • Tag each one with its corresponding category title (e.g. "Installation", "Main concepts", "Advanced guides", etc.) and "docs"/"tutorial"
  • assign the issue
  • see closed (i.e. completed) pages.

Advantages:

  • This issue is going to be (if not already) very messy and hard to follow as number of comments in the thread grows over time.

We'll have the ability to

  • search by assignee,
  • search by tags (i.e. to see how many of "doc" page are translated),
  • see when the issue was assigned to someone. so we'll found out if they've been assigned 26 days ago and there's been no progress for that page. We can then remove them from being an assignee so other people can work on it.
  • reference the issue in its PR

Thought it's better to share the idea before executing it. Let me know what you think.

iamhosseindhv avatar Mar 05 '19 02:03 iamhosseindhv

It's fine to split everything up into different issues, but we don't recommend it. There are 88 pages here, which means 88 issues. It's hard to keep track of, especially if the more important issues like "Getting Started" get pushed past the first page.

If you're concerned about the page being already too long, you can check a more complete translation like Spanish to see if it seems cluttered or disorganized.

Regardless what you decide on, I'll ask that you keep this issue open and updated, since isreacttranslatedyet.com (our official tracking) relies on it.

tesseralis avatar Mar 05 '19 05:03 tesseralis

I am doing "Components and Props".

mohsenkhanpour avatar Mar 05 '19 12:03 mohsenkhanpour

Hey @mohsenkhanpour Great to have you on board! I assigned that to you. Let me know if you have any question.

sorousht avatar Mar 05 '19 12:03 sorousht

I'll get stared on the "Forms" section. All right?

mjraadi avatar Mar 06 '19 11:03 mjraadi

Hey @mjraadi Welcome :) I assign it to you. Please feel free to ask any question.

sorousht avatar Mar 06 '19 12:03 sorousht

I want Fragments to translate

mvahedii avatar Mar 06 '19 12:03 mvahedii

Hi @Mvahedii We suggest starting with core pages. Would you mind if you pick one of the remaining from Basics? Here are three options:

  • Lifting State Up
  • Composition vs Inheritance
  • Thinking in React

If you are not interested in the above pages, I will assign the one you requested (Fragments).

sorousht avatar Mar 06 '19 13:03 sorousht

@sorousht I'd love to take "Lifting State Up" page, you're doing great here :)

morajabi avatar Mar 07 '19 07:03 morajabi

Hey @morajabi Thanks, It's a pleasure having you with us :) I've just assigned the page to you.

sorousht avatar Mar 07 '19 08:03 sorousht

@sorousht Ok I am doing Thinking in React. All Right!?

mvahedii avatar Mar 07 '19 18:03 mvahedii

@Mvahedii Perfect! I assign it to you :)

sorousht avatar Mar 07 '19 18:03 sorousht

Hey! I'm gonna do "Composition vs Inheritance". Is that alright?

foadms avatar Mar 07 '19 20:03 foadms

Hey @foadms Welcome, It is assigned to you :) Feel free to ask any question.

sorousht avatar Mar 07 '19 20:03 sorousht

Hi @Schabaani, Any update on "Hello World"?

sorousht avatar Mar 09 '19 11:03 sorousht

Can I work on Shallow Renderer?

amiratak88 avatar Mar 20 '19 22:03 amiratak88

Hi @amiratak88 Sure, I assign it to you.

sorousht avatar Mar 20 '19 23:03 sorousht

Wasn't sure if I had to create a new issue for this, but do u guys have a slack workspace/telegram group where we could chat and ask questions? Or do u think we should create one?

amiratak88 avatar Mar 21 '19 04:03 amiratak88

Hi @amiratak88 the Iran React Community Group Link is here : https://b2n.ir/ir-react

mvahedii avatar Mar 21 '19 12:03 mvahedii

Wasn't sure if I had to create a new issue for this, but do u guys have a slack workspace/telegram group where we could chat and ask questions? Or do u think we should create one?

@amiratak88 Please feel free to file an issue if you have any question. Additionally, We have a Slack workspace for further discussions. I just sent you an invitation.

sorousht avatar Mar 21 '19 13:03 sorousht

Wasn't sure if I had to create a new issue for this, but do u guys have a slack workspace/telegram group where we could chat and ask questions? Or do u think we should create one?

سلام . صفحه اصلی جامعه ری اکت ایران در گیت :‌ https://iran-react-community.github.io/ شما میتوانید از طریق لینک ها ما را دنبال کنید

nimahkh avatar Mar 22 '19 10:03 nimahkh

Hi! can I get "React" from "API Reference"?

mahdinba97 avatar Mar 23 '19 16:03 mahdinba97