<!--  do not translate this -->
| [Read these guidelines in other languages](/docs/i18n-languages) |
|-|
<!--  do not translate this -->

<div dir="rtl" style="direction: rtl" markdown="1">

# قواعد المساهمة

مرحبا!  👋

إن مشروع freeCodeCamp.org هو مشروع قائم بسبب جهود الآلاف من المتطوعين الجيدين!  نحن نشعر بالأمتنان لتطوعك, و نحن سعيدين بإنضمامك لنا! 

نحن نطبق بشدة [القواعد السلوكية](https://www.freecodecamp.org/code-of-conduct).  أقرأ هذه المقالة جيدا, إنها مجرد 196 كلمة. 

🎉

## بعض الطرق المساهمة

1. [ تطوع لهذا الcodebase](#تطوع-لهذا-الcodebase).  ساعد في إعداد [مقالات الدليل](https://guide.freecodecamp.org/), [تحديات الcoding](https://learn.freecodecamp.org/), أو تشخيص المشاكل في برنامج التعليم. 

2.  ساعد المخيمين (المستخدمين) على [المنتدى العام](https://forum.freecodecamp.org/). [ أجب عن أسئلتهم](https://forum.freecodecamp.org/?max_posts=1) او [أعطهم رأيك على مشاريعهم](https://forum.freecodecamp.org/c/project-feedback?max_posts=1)

3.  ساعد في إضافة ترجمة إلى مقاطع الفيديو على [قناتنا على الYouTube](https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ/videos)

## تطوع لهذا الcodebase

لدينا codebase ضخمة جدا مفتوحة المصدر مؤلفة من الآلاف من [تحديات البرمجة](https://learn.freecodecamp.org) و [مقالات الدليل](https://guide.freecodecamp.org). 

يمكنك المساعدة عن طريق:

- [📝 القيام بالأبحاث و كتابة و تحديث مقالات الدليل](#القيام-بالأبحاث-و-كتابة-و-تحديث-مقالات-الدليل)

- [💻 إنشاء و تحديث و إصلاح الأخطاء في تحديات البرمجة](#إنشاء-و-تحديث-و-إصلاح-الأخطاء-في-تحديات-البرمجة)

- [🌐 المساعدة في ترجمة مقالات الدليل و تحديات البرمجة](#المساعدة-في-ترجمة-مقالات-الدليل-و-تحديات-البرمجة)

- [🛠 ساعد في إصلاح الأخطاء في برنامج تعليم freeCodeCamp.org](#ساعد-في-إصلاح-الأخطاء-في-برنامج-تعليم-freecodecamporg)

### القيام بالأبحاث و كتابة و تحديث مقالات الدليل

**ما هي مقالات الدليل؟** 

مقالات الدليل تساعد في الحصول على فهم سريع لفكرة تقنية معينة.  المقالات هي عبارة عن شرح قصير و مكتوب بلغة سهلة و التي يمكنك قرائتها قبل البدء في شروحات اكثر تفصيلا. 

على سبيل المثال يمكنك أن تجد [مثالا عن ال HTML Elements هنا](./client/src/pages/html/elements/index.md)

**عن ماذا يمكنني كتابة مقالة؟** 

نحن نرحب في مساعدتك لكتابة تلك المقالات.  ليس عليك أن تكون خبيرا في الموضوع لكي تكتب مقالة - هذه المقالات مفتوحة المصدر, فمثلا لو كتبت شيئا خاطئا, أي متطوع آخر يمكنه اصلاح الخطأ في النهاية

من أجل المساعدة, قم بإيجاد `stub article` على [موقع الدليل](https://www.freecodecamp.org/guide), أكتب المقالة, ثم أنشئ Pull Request لأستبدال ذلك بمقالتك.  إن ال [Pull Requests](https://help.github.com/articles/about-pull-requests/) هو الطريقة التي ستقوم بأستعمالها لأقتراح التعديلات, فهي تسمح للآخرين بالأستعلام عن تعديلاتك و مراجعتها و اعتمادها. 

إذا لم تستطع أن تجد `stub article` حول الموضوع الذي تريد الكتابة عنه, يمكنك ان إنشاء Pull Request تقوم فيه بإنشاء `stub article` الذي يتضمن المسودة التي كتبتها. 

إذا كنت تريد المساعدة في تحسين مقالات الدليل, أقرا [هذه المقالة عن كيفية القيام ذلك](/docs/how-to-work-on-guide-articles.md). 

### إنشاء و تحديث و إصلاح الأخطاء في تحديات البرمجة

كل التحديات هي مصنوعة من قبل عامة المجتمع, بشكل يضع خبرات عالية من اشخاص مثلك. 

يمكنك المساعدة في زيادة التوسع في التحديات و تعديلها بشكل تصبح أكثر وضوحا.  يمكنك تعديل قصص المستخدمين لتجعل الفكرة أفضل, و حتى إزالة القصص المتكررة.  يمكنك أيضا تحسين أختبارات التحديات لتجعلها قادرة على أختبار الcode بشكل أفضل و أكثر دقة. 

إذا كنت مهتم في تحسين تلك التحديات, أقرأ [هذه المقالة عن كيفية القيام بذلك](/docs/how-to-work-on-coding-challenges.md). 

### المساعدة في ترجمة مقالات الدليل و تحديات البرمجة

يمكنك المساعدة في ترجمة مقالات الدليل و تحديات البرمجة إلى لغة يمكنك التكلم بها.  حاليا لدينا إصدارات باللغات التالية:

- [Chinese (中文)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/chinese)
- [Russian (русский)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/russian)
- [Arabic (عربي)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/arabic)
- [Spanish (Español)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/spanish)
- [Portuguese (Português)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/portuguese)

نحن نود أن تساعدنا في تحسين جودة هذه الترجمات.  الملايين من الأشخاص يستعملون الموقع باللغة الأنكليزية, و نحن نتوقع الملايين الأخرى من المستخدمين أن تستعمل الموقع باللغات الأخرى أيضا. 

### ساعد في إصلاح الأخطاء في برنامج تعليم freeCodeCamp.org

إن برنامجنا التعليمي يعمل على مجموعة برامج JavaScript حديثة.  هناك الكثر من المكونات و الأدوات و المكتبات, منها Node.js و MongoDB و LoopBack و OAuth 2.0 و React و Gatsby و Webpack و المزيد ايضا. 

بشكل عام,

- لدينا Node.js API server. 
- مجموعة من برامج المستخدم المبنية باستخدام React. 
- Script نستعمله من أجل تقييم برامج ال Front-end. 

المشاركة في هذا يتطلب بعض المفاهيم حول ال APIs و ES6 Syntax, و الكثير من الشغف. 

بشكل أساسي, نحن نتوقع معرفة بسيطة معينة حول التقنيات و الأدوات و المكتبات المذكورة سابقا.  و مع ذلك, أنت ليس عليك أن تكون خبيرا بهم. 

يمكنك دوما الأستفسار عن أية أسئلة لديك على الissues المتعلقة بالموضوع و نحن سنكون سعيدين بإجابتنا لأستفسارك.  في حال شعرت بالأرتياب حول موضوع ما, يمكنك التحدث مع [`@raisedadead`](https://github.com/raisedadead) أو [`@bouncey`](https://github.com/bouncey) من فريق المطورين لدينا لتقديم المساعدة لك. 

إذا كنت تريد المساعدة في تحسين الcodebase لدينا, أقرأ [كيف تقوم بتشغيل البرنامج محليا](/docs/how-to-setup-freecodecamp-locally.md). 

## أسئلة شائعة

**كيف يمكنني أن أخبر عن مشكلة و التي هي ليست مطروحة؟** 

إذا كنت تظن أنك قد وجدت مشكلة, أقرأ اولا مقالة ["Help I've Found a Bug"](https://forum.freecodecamp.org/t/how-to-report-a-bug/19543) و تتبع الخطوات هناك. 

إذا كنت متيقنا أنها مشكلة جديدة, قم بإنشاء issue جديدة على GitHub.  كن متأكدا انها تتضمن أكثر معلومات ممكنة حتى نتمكن من تجريب المشكلة لدينا.  لدينا قالب مخصص ليساعدك في ذلك. 

ننوه إلى أن اي issue مفتوحة لأجل طلب المساعدة في تحدي برمجة سوف يتم إقفالها.  ذلك لأن استخدام ال issues محصور في مشاكل و مناقشات الcodebase.  قم [بطلب المساعدة على المنتدى](https://forum.freecodecamp.org) قبل التبليغ عن المشكلة إن كنت تشعر بالأرتياب. 

**كيف يمكنني أن أبلغ عن مشكلة أمنية؟** 

رجاء لا تقم بإنشاء issue على GitHub للمشاكل المتعلقة بالأمن.  بدلا من ذلك أرسل إلى بريدنا الألكتروني `security@freecodecamp.org` و سنقوم بإلقاء نظرة مباشرة. 

**لدي مشكلة في شيئ ما ليس موجودا ضمن هذه المستندات.  كيف يمكنني أن أجد المساعدة؟** 

يمكنك الأتسفسار عن أسئلتك عن طريق:

- [فئة "Contributors" في المنتدى العام](https://forum.freecodecamp.org/c/contributors)
- [المتطوعين على غرفة الدردشة في Gitter](https://gitter.im/FreeCodeCamp/Contributors)

نحن متشوقين لمساعدتك في التطوع لأي من المواضيع التي تريد العمل عليها.  كن متأكدا أن تقوم بالبحث على سؤالك قبل طرحه.  كن مؤدبا و أنتظر الأجابة.  إن المتطوعين و المسؤولين لدينا دائما موجودون لمسعادتك في أية مشكلة لديك. 

**أنا جديد على أستخدام GitHub و حتى على فكرة البرامج مفتوحة المصدر:**

أقرأ عن [كيفية التطوع للبرامج المفتوحة المصدر](https://github.com/freeCodeCamp/how-to-contribute-to-open-source)

**ماذا تعني مختلف الطوابع الموجودة على الissues؟** 

إن المسؤولين لدينا يقومون [بتنظيم](https://en.wikipedia.org/wiki/Software_bug#Bug_management) الissues و الPull Requests بحسب الأولوية و الخطورة و عوامل أخرى.  يمكنك أن تجد [قاموس المطلحات هنا](https://github.com/freecodecamp/freecodecamp/labels). 

يجب أن تلق نظرة على الissues ذات الطوابع **`Help Wanted`** أو **`first timers only`** من أجل نظرة سريعة على ما هو متوفر و الذي يمكنك العمل عليه.  يفضل أن تقوم بالعمل على تلك الissues قبل الأنتقال إلى ما بعد ذلك. 

إن كانت تلك الissues غير واضحة حول ما هو مطلوب فعله, يمكنك أن تسأل في قسم التعليقات على الissue. 

**لقد وجدت خطأ كتابي, هل علي أن أقوم بالتبليغ عنه قبل إنشاء Pull Request؟** 

من أجل أخطاء كتابية و مشاكل مشابهة يمكنك مباشرة أن تقوم بإنشاء Pull Request دون أن تقوم بإنشاء issue مسبقا.  إن ال issues هي مخصصة بشكل أكثر للمشاكل الأكبر و المتعلقة بالcode او مشاكل بنيوية في المنهج. 

</div>
