diff --git a/README.md b/README.md
index 9b8203644..2aa24eb71 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 [isreactreadyyet.com](https://www.isreactreadyyet.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.
+
+
+
+اگر این صفحه را مشاهده می‌کنید، احتمالا به ترجمه فارسی اسناد ری‌اکت (react) علاقه‌مند هستید. پس خوش آمدید!
+
+
+
+این مخزن کد (repo) با هدف توسعه اسناد ری‌اکت به زبان فارسی، از reactjs/reactjs.org انشعاب (fork) گرفته‌است و پیوسته با نسخه اصلی همگام‌سازی می‌شود.
+
+
+
+پیشرفت نسخه فارسی را از isreacttranslatedyet.com دنبال کنید.
+
+
+چگونه مشارکت کنم؟
+
+
+پیشنهاد می‌شود به‌ترتیب از لینک‌های زیر شروع کنید:
+
+
+
+
+دریافت کد
+
+
+
+پیش‌نیارها
+
+
+
+
+نصب
+
+```bash
+# 1. یک کپی از مخزن کد بگیرید
+git clone git@github.com:reactjs/fa.reactjs.org.git
+
+# 2. به شاخه اصلی پروژه بروید
+cd fa.reactjs.org
+
+# 3. وابستگی‌های npm سایت را نصب کنید
+yarn
+```
+
+اجرا
+
+```bash
+# سرور توسعه با قابلیت بارگذاری خودکار را اجرا کنید (قدرت گرفته از Gatsby)
+yarn dev
+```
+
+
+حالا آدرس http://localhost:8000 را در مرورگر دلخواه خود باز کنید و تمام!
+
+
+سوالی دارید؟
+
+
+اگر سوالی دارید با نگاه‌دارندگان تماس بگیرید یا یک موضوع (issue) جدید ثبت کنید!
+
+
+نگاه‌دارندگان
+
+
+
+
+مجوز
+
+
+محتوایی که در reactjs.org قرار می‌گیرد، تخت مجوز CC-BY-4.0 منتشر می‌شود که جزئیات آن در LICENSE-DOCS.md آمده‌است.
+
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}