From 564dbc705f709029e0092967e3c31b8f2f75de43 Mon Sep 17 00:00:00 2001 From: Alexander Kuznetsov Date: Sun, 10 Feb 2019 18:28:06 +0300 Subject: [PATCH 1/5] Descriptive link text for accessibility (#1659) --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 47daaedf9..4b3bbb6e6 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -89,7 +89,7 @@ Let's recap what happens in this example: > >React treats components starting with lowercase letters as DOM tags. For example, `
` represents an HTML div tag, but `` represents a component and requires `Welcome` to be in scope. > ->You can read more about the reasoning behind this convention [here.](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized) +>To learn more about the reasoning behind this convention, please read [JSX In Depth](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). ## Composing Components {#composing-components} From 6dea652a709af39e90a88be45f0f45849ab29d17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=BAlio=20Gomes?= <38530342+JulioGsn@users.noreply.github.com> Date: Sun, 10 Feb 2019 13:53:46 -0200 Subject: [PATCH 2/5] Fixed broken link in readme.md file (#1661) * Fixed broken link on readme.md file * Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9b8203644..ed0651b9f 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,7 @@ The documentation is divided into several sections with a different tone and pur ## Translation -If you are interesting in translating `reactjs.org`, please see the current translation efforts at [isreactreadyyet.com](https://www.isreactreadyyet.com). +If you are interesting in translating `reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/). If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg). From af28db58135a1bea4a528f3679515b2015801649 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 19:39:54 +0330 Subject: [PATCH 3/5] Update README.md Translate the original version and add some new sections to help new contributors --- README.md | 184 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 114 insertions(+), 70 deletions(-) diff --git a/README.md b/README.md index ed0651b9f..6ec6046da 100644 --- a/README.md +++ b/README.md @@ -1,70 +1,114 @@ -# reactjs.org - -This repo contains the source code and documentation powering [reactjs.org](https://reactjs.org/). - -## Getting started - -### Prerequisites - -1. Git -1. Node: any 8.x version starting with 8.4.0 or greater -1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/) -1. A fork of the repo (for any contributions) -1. A clone of the [reactjs.org repo](https://github.com/reactjs/reactjs.org) on your local machine - -### Installation - -1. `cd reactjs.org` to go into the project root -1. `yarn` to install the website's npm dependencies - -### Running locally - -1. `yarn dev` to start the hot-reloading development server (powered by [Gatsby](https://www.gatsbyjs.org)) -1. `open http://localhost:8000` to open the site in your favorite browser - -## Contributing - -### Guidelines - -The documentation is divided into several sections with a different tone and purpose. If you plan to write more than a few sentences, you might find it helpful to get familiar with the [contributing guidelines](https://github.com/reactjs/reactjs.org/blob/master/CONTRIBUTING.md#guidelines-for-text) for the appropriate sections. - -### Create a branch - -1. `git checkout master` from any folder in your local `reactjs.org` repository -1. `git pull origin master` to ensure you have the latest main code -1. `git checkout -b the-name-of-my-branch` (replacing `the-name-of-my-branch` with a suitable name) to create a branch - -### Make the change - -1. Follow the "Running locally" instructions -1. Save the files and check in the browser - 1. Changes to React components in `src` will hot-reload - 1. Changes to markdown files in `content` will hot-reload - 1. If working with plugins, you may need to remove the `.cache` directory and restart the server - -### Test the change - -1. If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile. -1. Run `yarn check-all` from the project root. (This will run Prettier, ESLint, and Flow.) - -### Push it - -1. `git add -A && git commit -m "My message"` (replacing `My message` with a commit message, such as `Fixed header logo on Android`) to stage and commit your changes -1. `git push my-fork-name the-name-of-my-branch` -1. Go to the [reactjs.org repo](https://github.com/reactjs/reactjs.org) and you should see recently pushed branches. -1. Follow GitHub's instructions. -1. If possible, include screenshots of visual changes. A Netlify build will also be automatically created once you make your PR so other people can see your change. - -## Translation - -If you are interesting in translating `reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/). - - -If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg). - -## Troubleshooting - -- `yarn reset` to clear the local cache - -## License -Content submitted to [reactjs.org](https://reactjs.org/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/open-source-explorer/reactjs.org/blob/master/LICENSE-DOCS.md) file. +

نسخه فارسی reactjs.org

+ +

+اگر این صفحه را مشاهده می‌کنید، احتمالا به ترجمه فارسی اسناد ری‌اکت (react) علاقه‌مند هستید. پس خوش‌ آمدید! +

+ +

+این رپو (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود. +

+ +

+پیشرفت نسخه فارسی را از isreacttranslatedyet.com دنبال کنید. +

+ +

چگونه مشارکت کنم؟

+ +

+پیشنهاد می‌شود به‌ترتیب از لینک‌های زیر شروع کنید: +

+ + +

+دریافت کد +

+ +

+پیش‌نیارها +

+ +
    +
  • + Git +
    • +
  • + Node.js نسخه ۸ (بعد از ۸.۴.۰) +
    • +
  • + Yarn +
    • +
+ +

نصب

+ +```bash +# 1. Clone the repo +git clone git@github.com:reactjs/fa.reactjs.org.git + +# 2. Go into the project root +cd fa.reactjs.org + +# 3. Install the website's npm dependencies +yarn +``` + +

اجرا

+ +```bash +# Start the hot-reloading development server (powered by Gatsby) +yarn dev +``` + +

+حالا آدرس http://localhost:8000 را در مرورگر دلخواه خود باز کنید و تمام! +

+ +

سوالی دارید؟

+ +‌

+اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک مورد (issue) جدید ثبت کنید! +

+ +

نگاه‌دارندگان

+ + + + +

مجوز

+ +

+محتوایی که در reactjs.org قرار می‌گیرد، تخت مجوز CC-BY-4.0 منتشر می‌شود که جزئیات آن در LICENSE-DOCS.md آمده‌است. +

From f8a9c04b63b77b09c9cbd1caacd4f87994997321 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 20:18:31 +0330 Subject: [PATCH 4/5] Use a better word for "repo" translation --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6ec6046da..24a8382cf 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@

-این رپو (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود. +این مخزن (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود.

From 6838cde74ce3244448b6637135a57b6fb991c875 Mon Sep 17 00:00:00 2001 From: Soroush Torkzadeh Date: Mon, 11 Feb 2019 23:56:20 +0330 Subject: [PATCH 5/5] Apply @masoud-bahrami comments on README.md --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 24a8382cf..2aa24eb71 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@

-این مخزن (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org فورک (fork) شده‌است و هر روز با نسخه اصلی همگام‌سازی می‌شود. +این مخزن کد (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org انشعاب (fork) گرفته‌است و پیوسته با نسخه اصلی همگام‌سازی می‌شود.

@@ -58,20 +58,20 @@

نصب

```bash -# 1. Clone the repo +# 1. یک کپی از مخزن کد بگیرید git clone git@github.com:reactjs/fa.reactjs.org.git -# 2. Go into the project root +# 2. به شاخه اصلی پروژه بروید cd fa.reactjs.org -# 3. Install the website's npm dependencies +# 3. وابستگی‌های npm سایت را نصب کنید yarn ```

اجرا

```bash -# Start the hot-reloading development server (powered by Gatsby) +# سرور توسعه با قابلیت بارگذاری خودکار را اجرا کنید (قدرت گرفته از Gatsby) yarn dev ``` @@ -82,7 +82,7 @@ yarn dev

سوالی دارید؟

‌

-اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک مورد (issue) جدید ثبت کنید! +اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک موضوع (issue) جدید ثبت کنید!

نگاه‌دارندگان