From 680414e4d97d63a5e39d5f53bef6bf66ed39f9d1 Mon Sep 17 00:00:00 2001
From: Soroush Torkzadeh <soroush.torkzadeh@gmail.com>
Date: Sun, 10 Feb 2019 23:00:50 +0330
Subject: [PATCH 1/2] Add STYLE-GUID.md

---
 STYLE-GUIDE.md | 109 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 STYLE-GUIDE.md

diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md
new file mode 100644
index 000000000..debc8b44f
--- /dev/null
+++ b/STYLE-GUIDE.md
@@ -0,0 +1,109 @@
+<h1 dir="rtl">شیوه‌ نگارش</h1>
+
+<p dir="rtl">
+برای حفظ یکپارچگی ترجمه در تمام صفحات و همچنین میان سایر زبان‌ها، لطفا قوانین زیر را مدنظر داشته‌باشید.
+</p>
+
+<h2 dir="rtl">آی‌دی عنوان‌ها</h2>
+
+<p dir="rtl">هر عنوانی یک آی‌دی منحصربه‌فرد دارد، مانند زیر:</p>
+
+```md
+## Try React {#try-react}
+```
+<p dir="rtl">از ترجمه آی‌دی‌ها <b>بپرهیزید</b>! از آن‌ها برای هدایت به بخش‌های مختلف یک صفحه استفاده می‌شود. به خصوص اگر کاربر از یک لینک خارجی به یک بخش مورد نظر از صفحه هدایت شده‌باشد، این قابلیت از کار خواهد افتاد. برای مثال:</p>
+
+```md
+See the [beginning section](/getting-started#try-react) for more information.
+```
+
+<p dir="rtl">✅ صحیح:</p>
+
+```md
+## ری‌اکت را امتحان کنید {#try-react}
+```
+
+<p dir="rtl">❌ غلط:</p>
+
+```md
+## ری‌اکت را امتحان کنید {#react-ra-emtehan-konid}
+```
+<p dir="rtl">ترجمه باعث از کار افتادن لینک بالا شده‌است.</p>
+
+
+<h2 dir="rtl">متن در کد</h2>
+<p dir="rtl">
+فقط کامنت‌های یک کد را ترجمه کنید. شاید در بعضی موارد نیاز به ترجمه string باشد، اما نسبت به مواردی که ممکن است در منطق کد تغییر ایجاد کند آگاه باشید!
+</p>
+
+<p dir="rtl">مثال:</p>
+
+```js
+// Example
+const element = <h1>Hello, world</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+<p dir="rtl">✅ صحیح:</p>
+
+```js
+// مثال
+const element = <h1>Hello, world</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+<p dir="rtl">✅ صحیح:</p>
+
+```js
+// مثال
+const element = <h1>سلام، دنیا</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+<p dir="rtl">❌ غلط:</p>
+
+```js
+// مثال
+const element = <h1>سلام، دنیا</h1>;
+// "root" به آی‌دی یک تگ اشاره دارد
+// نباید آن را ترجمه کرد!
+ReactDOM.render(element, document.getElementById('ریشه'));
+```
+
+<p dir="rtl">❌ کاملا غلط:</p>
+
+```js
+// مثال
+const eleman = <h1>سلام، دنیا</h1>;
+ReactDOM.render(eleman, sanad.yaftanElemeanBaId('ریشه'));
+
+```
+<h2 dir="rtl">لینک‌های خارجی</h2>
+<p dir="rtl">
+اگر یک لینک خارجی به یک مقاله از منابعی مانند <a href="https://developer.mozilla.org/fa/" taget="_blank">شبکه توسعه‌دهنگان موزیلا (MDN)</a> و <a href="https://en.wikipedia.org/wiki/Main_Page" taget="_blank">ویکی‌پدیا (Wikipedia)</a>  ارجاع داده‌  شده‌است، در صورتی که نسخه فارسی آن مقاله موجود و از کیفیت مناسبی برخوردار است، به نسخه فارسی ارجاع داده‌شود.
+</p>
+
+<p dir="rtl">مثال:</p>
+
+<p>
+A stateful component inherits <code>Component</code> <a href="https://en.wikipedia.org/wiki/Class_(computer_programming)" target="_blank">class</a>.
+</p>
+
+
+
+<p dir="rtl">✅ صحیح:</p>
+<p dir="rtl">
+یک کامپوننت دارای state از <a href="https://fa.wikipedia.org/wiki/%DA%A9%D9%84%D8%A7%D8%B3_(%D8%A8%D8%B1%D9%86%D8%A7%D9%85%D9%87%E2%80%8C%D9%86%D9%88%DB%8C%D8%B3%DB%8C)" target="_blank">کلاس</a> <code>Component</code> ارث می‌برد.
+</p>
+<br />
+<p dir="rtl">
+برای لینک‌هایی که معادل فارسی ندارند مثل Stack Overflow و ویدیو‌های YouTube، از همان لینک انگلیسی استفاده‌شود.
+</p>
+
+<h2 dir="rtl">زبان فارسی</h2>
+<p dir="rtl">
+هدف تمام مشارکت‌کنندگان تولید محتوای فارسی با بهترین کیفیت ممکن است تا به منبعی قابل استفاده برای همگان تبدیل شود. قطعا دستیابی به این هدف بدون رعایت شیوه‌ نگارش استاندارد فارسی میسر نخواهد‌شد. اگر نیاز به یک یادآوری داشتید، مقاله <a href="https://virastaran.net/a/v/m/e/eh/148/" target="_blank">شیوه‌نامۀ «ویراستاران» برای نگارش در وب</a> منبع مناسبی است.
+</p>
+<p dir="rtl">
+اگر فکر می‌کنید چیزی فراموش شده‌است یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید.
+</p>
\ No newline at end of file

From 4050dec6617153d92a54881b0ee733ae8d0ca562 Mon Sep 17 00:00:00 2001
From: Soroush Torkzadeh <soroush.torkzadeh@gmail.com>
Date: Mon, 11 Feb 2019 12:45:59 +0330
Subject: [PATCH 2/2] Fix STYLE-GUIDE.md

 - Fix ID translation
 - Just translate comments of a code block and leave the other parts
---
 STYLE-GUIDE.md | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md
index debc8b44f..81cf2ed52 100644
--- a/STYLE-GUIDE.md
+++ b/STYLE-GUIDE.md
@@ -4,18 +4,15 @@
 برای حفظ یکپارچگی ترجمه در تمام صفحات و همچنین میان سایر زبان‌ها، لطفا قوانین زیر را مدنظر داشته‌باشید.
 </p>
 
-<h2 dir="rtl">آی‌دی عنوان‌ها</h2>
+<h2 dir="rtl">شناسه عنوان‌ها</h2>
 
-<p dir="rtl">هر عنوانی یک آی‌دی منحصربه‌فرد دارد، مانند زیر:</p>
+<p dir="rtl">هر عنوانی یک شناسه منحصربه‌فرد دارد، مانند زیر:</p>
 
 ```md
 ## Try React {#try-react}
 ```
-<p dir="rtl">از ترجمه آی‌دی‌ها <b>بپرهیزید</b>! از آن‌ها برای هدایت به بخش‌های مختلف یک صفحه استفاده می‌شود. به خصوص اگر کاربر از یک لینک خارجی به یک بخش مورد نظر از صفحه هدایت شده‌باشد، این قابلیت از کار خواهد افتاد. برای مثال:</p>
+<p dir="rtl">از ترجمه شناسه‌ها <b>بپرهیزید</b>! از آن‌ها برای هدایت به بخش‌های مختلف یک صفحه استفاده می‌شود. به خصوص اگر کاربر از یک لینک خارجی به یک بخش مورد نظر از صفحه هدایت شده‌باشد، این قابلیت از کار خواهد افتاد.</p>
 
-```md
-See the [beginning section](/getting-started#try-react) for more information.
-```
 
 <p dir="rtl">✅ صحیح:</p>
 
@@ -33,7 +30,7 @@ See the [beginning section](/getting-started#try-react) for more information.
 
 <h2 dir="rtl">متن در کد</h2>
 <p dir="rtl">
-فقط کامنت‌های یک کد را ترجمه کنید. شاید در بعضی موارد نیاز به ترجمه string باشد، اما نسبت به مواردی که ممکن است در منطق کد تغییر ایجاد کند آگاه باشید!
+فقط کامنت‌های یک کد را ترجمه کنید. از ترجمه دیگر بخش‌های کد بپرهیزید.
 </p>
 
 <p dir="rtl">مثال:</p>
@@ -52,7 +49,7 @@ const element = <h1>Hello, world</h1>;
 ReactDOM.render(element, document.getElementById('root'));
 ```
 
-<p dir="rtl">✅ صحیح:</p>
+<p dir="rtl">❌ غلط:</p>
 
 ```js
 // مثال
@@ -65,7 +62,7 @@ ReactDOM.render(element, document.getElementById('root'));
 ```js
 // مثال
 const element = <h1>سلام، دنیا</h1>;
-// "root" به آی‌دی یک تگ اشاره دارد
+// "root" به شناسه یک تگ اشاره دارد
 // نباید آن را ترجمه کرد!
 ReactDOM.render(element, document.getElementById('ریشه'));
 ```