> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# أول مساهمة في مشروع مفتوح المصدر: من Issue إلى Pull Request
- URL: https://arabroot.io/articles/اول-مساهمة-في-مشروع-مفتوح-المصدر-من-issue-الى-pull-request/
- Published: 2026-11-14T14:33:09.000Z
- Updated: 2026-11-14T19:51:53.000Z
- Description: عشر خطوات لأول مساهمة لك في مشروع مفتوح المصدر، من اختيار البلاغ والتعليق فيه إلى فتح طلب الدمج والرد على المراجعة، وما يتوقعه منك المشرفون في كل خطوة.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, للطلاب والخريجين

إذا كنت طالباً وتريد أن تساهم في مشروع مفتوح المصدر Open Source لأول مرة، ولا تعرف من أين تبدأ ولا ماذا يتوقع منك المشرفون، فهذا المقال لك. وهو للطالب الذي يعرف أساسيات Git ويستطيع أن يكتب كوداً يعمل، لكنه لم يرسل تعديلاً إلى مشروع لا يعرف أصحابه.

والمساهمة الأولى ليست صعبة تقنياً في الغالب. فأغلب التعديلات الأولى إصلاح صغير أو تحسين في التوثيق. الصعب هو الطريق حول الكود: كيف تختار البلاغ، ومتى تكتب فيه، وكيف تصف طلبك، وكيف ترد على المراجع، وماذا تفعل إذا لم يرد أحد.

وسوف نناقش في هذا المقال ما يلي:

- المصطلحات التي ستقابلها في الطريق، بكلمات بسيطة.
- لماذا لا تقبل أغلب المساهمات الأولى، بحسب دراسة على 21 مشروعاً مشهوراً.
- عشر خطوات من اختيار البلاغ Issue إلى دمج طلبك Pull Request، مع ما يتوقعه المشرف في كل خطوة.
- بيانات جمعناها من GitHub في 14 نوفمبر 2026 تبين لماذا يجب أن تتحقق من البلاغ قبل أن تبدأ.
- آداب التعامل مع المشرفين، واستخدام الذكاء الاصطناعي في المساهمة، والأخطاء الشائعة، وقائمة تحقق.

أما ما المصادر المفتوحة ورخصها ومن يدير المشاريع، فقد شرحناه في مقالين سابقين ولن نكرره هنا: [ما هي البرمجيات مفتوحة المصدر؟](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%8A-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D9%8A%D8%A7%D8%AA-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%AA%D8%B1%D8%A7%D8%AE%D9%8A%D8%B5%D9%87%D8%A7/) و[من يدير المشروع مفتوح المصدر؟](https://arabroot.io/articles/%D8%AD%D9%88%D9%83%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D8%B1%D9%8A%D8%B9-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%A7%D9%87%D9%85%D8%A9-%D9%81%D9%8A%D9%87%D8%A7/).

📋

**الخلاصة السريعة:**  
• اختر مشروعاً تستخدمه، واقرأ ملف CONTRIBUTING.md قبل أي شيء.  
• تحقق أن البلاغ غير مسند لأحد ولا يوجد له طلب دمج مفتوح، ثم اكتب فيه أنك تريد العمل عليه.  
• شغل المشروع واختباراته على جهازك قبل أن تغير سطراً.  
• طلب صغير في موضوع واحد، بوصف يقول ماذا غيرت ولماذا وكيف اختبرته.  
• رد على كل ملاحظة في نفس الطلب، وانتظر أسبوعاً قبل أن تذكر المراجع بأدب.  
• أنت مسؤول عن كل سطر ترسله، سواءً كتبته بنفسك أو ساعدك فيه الذكاء الاصطناعي.

## المصطلحات الأساسية Key Terms

هذه الكلمات ستقرؤها في كل صفحة من صفحات المشروع، فاعرفها قبل أن تبدأ:

| المصطلح                  | معناه ببساطة                                                                         |
| ------------------------ | ------------------------------------------------------------------------------------ |
| البلاغ Issue             | صفحة نقاش لمشكلة أو اقتراح، لها رقم مثل #123\. ومنها يبدأ أغلب العمل.                |
| المشرف Maintainer        | شخص يملك صلاحية دمج التعديلات في المشروع، وغالباً يعمل عليه منذ سنوات.               |
| النسخة في حسابك Fork     | نسخة من المستودع في حسابك، تعدل فيها لأنك لا تملك صلاحية الكتابة في المستودع الأصلي. |
| المستودع الأصلي Upstream | مستودع المشروع نفسه، الذي تريد أن يدخل تعديلك إليه.                                  |
| الفرع Branch             | خط عمل منفصل داخل المستودع، تضع فيه تعديلك حتى لا تخلطه بغيره.                       |
| طلب الدمج Pull Request   | طلب منك للمشرفين: «هذا تعديل في فرعي، هل تدمجونه؟». ويختصر PR.                       |
| المراجعة Review          | قراءة المشرف لتعديلك، مع تعليقات وطلب تغييرات أو موافقة.                             |
| الفحص الآلي CI           | اختبارات وفحوص تعمل تلقائياً على كل طلب دمج، ويجب أن تنجح قبل الدمج.                 |
| الوسم Label              | علامة على البلاغ مثل good first issue، أي «مناسب لأول مساهمة».                       |

وإذا كانت أوامر Git نفسها جديدة عليك فابدأ من [إدارة النسخ مع Git للمبتدئين](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D9%88-git-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/) ثم [أول مستودع Git لك](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-git-%D9%84%D9%83-%D9%85%D9%86-git-init-%D8%A7%D9%84%D9%89-%D8%A7%D9%88%D9%84-push-%D8%B9%D9%84%D9%89-gitea/). وإذا كنت تعرف Git ولم تفتح طلب دمج من قبل، فاقرأ أولاً قسم [ما هو طلب الدمج](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/#what-is-pr) في مقال مراجعة الكود Code Review.

## لماذا لا تقبل أغلب المساهمات الأولى؟

درس باحثون في 2018 واحداً وعشرين مشروعاً مشهوراً على GitHub، وبحثوا عن المطورين الذين أرسلوا طلبات دمج ولم يقبل لهم أي طلب. فوجدوا 10,099 مطوراً بهذا الوصف، أرسلوا 12,367 طلباً لم يقبل. وعددهم يعادل نحو 70% من عدد المساهمين الذين قبلت مساهماتهم في نفس المشاريع، وفي خمسة مشاريع كان عددهم أكبر من عدد المساهمين أنفسهم.

وأهم سببين لعدم القبول من وجهة نظر أصحاب الطلبات:

- **طلب مكرر أو سبقه غيره:** شخص آخر أرسل نفس الإصلاح قبله، أو حل المشرفون المشكلة بطريقة أخرى.
- **اختلاف مع رؤية الفريق:** التعديل يعمل، لكن المشرفين لا يريدونه بهذا الشكل أو لا يريدونه أصلاً.

وقال نحو 30% ممن شاركوا في استبيان الدراسة إن رفض طلبهم أحبطهم أو منعهم من إرسال طلب آخر. المصدر: [دراسة Almost There، مؤتمر ICSE 2018](https://users.ime.usp.br/~gerosa/papers/icse2018-Pinto.pdf?ref=arabroot.io).

ولاحظ أن السببين لا علاقة لهما بجودة الكود. فكلاهما يمنعه سؤال واحد في البلاغ قبل أن تبدأ: «هل يعمل أحد على هذا؟ وهل هذه الطريقة مقبولة؟». ولذلك أغلب الخطوات التالية عن التواصل، لا عن البرمجة.

وتؤكد ذلك مراجعة منهجية لـ 21 دراسة عن عوائق المساهمين الجدد في 2014\. فمن أكثر العوائق التي وجدتها: تأخر رد المجتمع على المساهم الجديد، وصعوبة معرفة من أين يبدأ، إلى جانب نقص المهارات التقنية السابقة. المصدر: [Barriers Faced by Newcomers to Open Source Projects](https://experts.nau.edu/en/publications/barriers-faced-by-newcomers-to-open-source-projects-a-systematic-/?ref=arabroot.io).

![الطريق من البلاغ إلى الدمج في عشر خطوات مقسمة إلى ثلاث مراحل: قبل الكود وفيها اختيار المشروع وقراءة الملفات واختيار البلاغ والتعليق فيه، ثم الكود وفيها تشغيل المشروع والتعديل الصغير وفتح الطلب، ثم بعد الكود وفيها المراجعة والانتظار والدمج، مع ما يتوقعه المشرف في كل مرحلة](https://arabroot.io/content/images/2026/11/oss-first-contribution-01-path.webp)

نصف الخطوات قبل أن تكتب سطراً من الكود

## من البلاغ إلى الدمج: عشر خطوات Step by Step

### 1\. اختر مشروعاً تستخدمه وما زال حياً

ابدأ بمشروع تستخدمه فعلاً: مكتبة في مشروع تخرجك، أو أداة تفتحها كل يوم، أو إضافة لمحرر الكود. فأنت تعرف مشكلاته من الاستخدام، وتستطيع أن تختبر إصلاحك بنفسك.

ثم تأكد أنه ما زال يعمل. افتح صفحة طلبات الدمج المغلقة وانظر: هل دمج المشرفون طلبات من أشخاص من خارج الفريق في الشهر الأخير؟ وهل يرد أحد على البلاغات الجديدة؟ فإذا كان آخر دمج قبل سنة فلا تبدأ منه.

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

### 2\. اقرأ ملفات المساهمة CONTRIBUTING قبل أي شيء

كل مشروع منظم يكتب للمساهمين ملفات في المجلد الرئيسي أو في المجلد `.github/`. وأهمها `CONTRIBUTING.md`، ففيه طريقة تشغيل المشروع والاختبارات، وشكل رسالة الـ Commit، وهل يطلب المشروع توقيعاً على كل Commit. وقد شرحنا هذه الملفات بالترتيب، والفرق بين التوقيع DCO والاتفاقية CLA، في قسم [الملفات التي تقرؤها أولاً](https://arabroot.io/articles/%D8%AD%D9%88%D9%83%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D8%B1%D9%8A%D8%B9-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%A7%D9%87%D9%85%D8%A9-%D9%81%D9%8A%D9%87%D8%A7/#files).

وبعض المشاريع الكبيرة لها دليل كامل للمساهمين بدل ملف واحد، مثل [دليل المطورين في Python](https://devguide.python.org/?ref=arabroot.io) و[دليل مطوري مترجم Rust](https://rustc-dev-guide.rust-lang.org/?ref=arabroot.io). والمشرف يتوقع أنك قرأت هذا الدليل، فأسئلة مثل «كيف أشغل الاختبارات؟» والإجابة مكتوبة فيه تعطي انطباعاً سيئاً من أول تعليق.

وانتبه لشيئين في هذه الملفات تحديداً:

- **أين يتم النقاش:** بعض المشاريع لا تستخدم بلاغات GitHub للأسئلة، وتطلب منك منتدى أو قناة محادثة.
- **هل يطلب المشروع بلاغاً قبل الطلب:** مشاريع كثيرة ترفض طلب دمج لميزة جديدة لم يناقشها أحد في بلاغ.

### 3\. اختر البلاغ وتحقق أنه متاح فعلاً

ابحث في البلاغات عن وسم المبتدئين. وتشرح وثائق GitHub أن الوسم good first issue يساعد الناس على إيجاد البلاغ عند البحث بالوسوم، وأن GitHub يستخدمه ليعرض البلاغات المناسبة للمبتدئين في أماكن مختلفة من الموقع. المصدر: [وثائق GitHub عن الوسوم](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/encouraging-helpful-contributions-to-your-project-with-labels?ref=arabroot.io).

لكن اسم الوسم يختلف بين المشاريع، فابحث عن الاسم الذي يستخدمه مشروعك. ففي CPython اسمه easy، وفي مترجم Rust اسمه E-easy، وفي Kubernetes وVS Code وNode.js اسمه good first issue.

والأهم من الوسم أن البلاغ ما زال متاحاً. وقد راجعنا في 14 نوفمبر 2026 البلاغات المفتوحة بوسم المبتدئين في ستة مشاريع مشهورة عبر واجهة البحث في GitHub، فوجدنا ما يلي:

| المشروع                   | اسم الوسم        | بلاغات مفتوحة بالوسم | منها غير مسندة لأحد | غير مسندة ولا طلب دمج مرتبط بها |
| ------------------------- | ---------------- | -------------------- | ------------------- | ------------------------------- |
| microsoft/vscode          | good first issue | 18                   | 0                   | 0                               |
| kubernetes/kubernetes     | good first issue | 6                    | 0                   | 0                               |
| nodejs/node               | good first issue | 0                    | 0                   | 0                               |
| scikit-learn/scikit-learn | Easy             | 0                    | 0                   | 0                               |
| python/cpython            | easy             | 65                   | 58                  | 35                              |
| rust-lang/rust            | E-easy           | 31                   | 14                  | 12                              |

والمعنى العملي لهذا الجدول:

- في المشاريع الأشهر تختفي بلاغات المبتدئين بسرعة. ففي VS Code وKubernetes كل البلاغات المفتوحة بالوسم مسندة لشخص ما يوم راجعناها.
- البلاغ المفتوح ليس بالضرورة متاحاً. ففي CPython من 65 بلاغاً، 35 فقط بلا شخص مسند ولا طلب دمج مرتبط.
- بعض المشاريع تستخدم الإسناد Assignee لشيء آخر، مثل المشرف المسؤول عن المنطقة، لا للمساهم الذي يعمل عليه. لذلك اقرأ آخر التعليقات أيضاً، ولا تعتمد على الإسناد وحده.

فقبل أن تبدأ أي بلاغ، افتح صفحته وتحقق من أربعة أشياء: هل هو مسند لأحد؟ هل يوجد طلب دمج مرتبط به في الجانب؟ هل كتب أحد في آخر أسبوعين أنه يعمل عليه؟ وهل رد المشرفون على البلاغ أصلاً، أم بقي بلا رد منذ أشهر؟ وطريقة البحث بهذه الشروط في [وثائق البحث في GitHub](https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests?ref=arabroot.io).

![أربعة أسئلة قبل أن تبدأ العمل على بلاغ: هل هو مسند لأحد، وهل يوجد طلب دمج مرتبط، وهل كتب أحد أنه يعمل عليه في آخر أسبوعين، وهل رد المشرفون عليه، وبجانبها أرقام الفحص في 14 نوفمبر 2026: في VS Code ثمانية عشر بلاغاً كلها مسندة، وفي Kubernetes ستة كلها مسندة، وفي CPython خمسة وستون منها خمسة وثلاثون متاحة، وفي Rust واحد وثلاثون منها اثنا عشر متاحة](https://arabroot.io/content/images/2026/11/oss-first-contribution-02-check-issue.webp)

البلاغ المفتوح ليس بالضرورة متاحاً، والأرقام من واجهة البحث في GitHub في 14 نوفمبر 2026

### 4\. اكتب في البلاغ قبل أن تبدأ العمل

هذه الخطوة تمنع السببين الأشهر للرفض. فاكتب تعليقاً قصيراً يقول ثلاثة أشياء: أنك تريد العمل على البلاغ، وكيف تفكر في حله في جملة أو جملتين، وسؤالاً واحداً إن كان لديك.

ومثال على تعليق جيد بالإنجليزية، لأنها لغة أغلب المشاريع: «I'd like to work on this. I plan to fix the date parsing in utils/date.py and add a test for the empty string case. Does that approach sound right?». ومثال على تعليق ضعيف: «Can I work on this?» وحده، فهو لا يقول للمشرف شيئاً عن فهمك للمشكلة.

ويوصي [دليل المساهمة في Open Source Guides](https://opensource.guide/how-to-contribute/?ref=arabroot.io) بفتح بلاغ والسؤال قبل أي عمل كبير. وإذا كان التعديل صغيراً جداً، مثل خطأ إملائي في التوثيق، فأغلب المشاريع تقبل طلب الدمج مباشرة دون بلاغ.

وبعض المشاريع لا تسند البلاغات للمبتدئين أبداً، وتقول في ملف المساهمة «أول طلب دمج يصل هو الذي يراجع». فإذا وجدت هذا فلا تنتظر الإسناد، واكتب تعليقك ثم ابدأ.

### 5\. شغل المشروع واختباراته قبل أن تغير شيئاً

انسخ المستودع إلى حسابك Fork من زر Fork في صفحة المشروع، ثم انسخه إلى جهازك بالأمر `git clone`، وأنشئ فرعاً باسم يصف التعديل بالأمر `git switch -c fix-date-parsing`. والخطوات بالصور في [وثائق GitHub لطلب الدمج من Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork?ref=arabroot.io).

ثم شغل المشروع واختباراته كما في CONTRIBUTING، قبل أي تعديل. والسبب بسيط: إذا فشل اختبار بعد تعديلك فيجب أن تعرف هل أنت من كسره أم كان فاشلاً من قبل. والمشاريع الكبيرة قد تأخذ ساعة أو أكثر في أول بناء، فخطط لذلك.

ثم أعد المشكلة على جهازك. فإذا كان البلاغ عن خطأ فاجعله يظهر عندك أولاً، واكتب الخطوات. وإذا لم تستطع إعادته فاكتب في البلاغ ما جربته، فهذه معلومة مفيدة للمشرف أيضاً. وقراءة رسائل الخطأ في هذه المرحلة مهارة مستقلة شرحناها في [قراءة الـ Stack Trace وتصحيح الأخطاء](https://arabroot.io/articles/%D9%82%D8%B1%D8%A7%D8%A1%D8%A9-%D8%B1%D8%B3%D8%A7%D9%84%D8%A9-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7-stack-trace-%D9%88%D8%A7%D9%84%D8%AA%D8%B5%D8%AD%D9%8A%D8%AD-debugging/).

### 6\. اجعل التعديل صغيراً وفي موضوع واحد

الطلب الصغير يراجع في دقائق، والطلب الكبير ينتظر أسابيع. ويقول [دليل المساهمة في curl](https://curl.se/dev/contribute.html?ref=arabroot.io) مثلاً: أصلح خطأً واحداً في كل مرة، وأرسل كل إصلاح منفصلاً. وهذه قواعد يتوقعها أغلب المشرفين:

- **موضوع واحد:** لا تصلح الخطأ وتعيد تنسيق الملف كله في نفس الطلب. فالمراجع لن يجد تعديلك بين مئات الأسطر.
- **أسلوب المشروع لا أسلوبك:** أسماء المتغيرات، والمسافات، وطريقة كتابة الاختبارات. انظر كيف كتب الكود المجاور واكتب مثله.
- **اختبار يثبت الإصلاح:** اختبار يفشل قبل تعديلك وينجح بعده. وإذا لم يكن الاختبار ممكناً فاكتب في الطلب كيف تحققت يدوياً.
- **رسالة Commit بشكل المشروع:** كثير من المشاريع تطلب سطراً أول قصيراً بصيغة الأمر، مثل «fix date parsing for empty input»، ثم سطراً فارغاً وشرحاً. وبعضها يطلب اسم الجزء في أول السطر.
- **لا أسرار في الكود:** لا رموز وصول Tokens ولا كلمات مرور من بيئتك. فطلب الدمج في مشروع عام يقرؤه الجميع، وما يدفع إليه يبقى في السجل. وطريقة الفحص في [اكتشاف الأسرار المسربة](https://arabroot.io/articles/%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%A7%D9%84%D9%85%D8%B3%D8%B1%D8%A8%D8%A9-%D9%85%D8%B9-gitleaks-%D9%88-trufflehog/).

### 7\. افتح طلب الدمج بوصف يسهل مراجعته

عنوان الطلب ووصفه هما أول ما يقرؤه المشرف. وإذا كان للمشروع قالب للوصف Template فاملأه كاملاً ولا تحذف أقسامه. وإذا لم يكن فاكتب هذه الأجزاء:

| الجزء         | ماذا تكتب                                                         |
| ------------- | ----------------------------------------------------------------- |
| العنوان       | ماذا يفعل التعديل، في سطر واحد بنفس شكل رسالة الـ Commit          |
| ماذا ولماذا   | المشكلة في جملتين، وما غيرته لحلها                                |
| كيف اختبرته   | الاختبار الذي أضفته، والأوامر التي شغلتها، والنظام الذي جربت عليه |
| الربط بالبلاغ | كلمة مثل Fixes #123، فيغلق GitHub البلاغ تلقائياً عند الدمج       |
| صور قبل وبعد  | إذا غير التعديل شيئاً في الواجهة                                  |
| ما لم يكتمل   | أي شيء لست متأكداً منه، أو سؤال للمراجع                           |

والكلمات التي تربط الطلب بالبلاغ وتغلقه عند الدمج، مثل Fixes وCloses وResolves، في [وثائق GitHub لربط الطلب بالبلاغ](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue?ref=arabroot.io).

وثلاثة أشياء تساعدك في هذه الخطوة:

- **الطلب المسودة Draft:** إذا أردت رأي المشرف قبل أن تنتهي، فافتح الطلب مسودة. ويشرح [GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests?ref=arabroot.io) أن المسودة لا يمكن دمجها حتى تعلن أنها جاهزة.
- **السماح للمشرفين بالتعديل:** عند فتح الطلب من Fork يوجد خيار يسمح للمشرفين بالدفع إلى فرعك. وفائدته أن المشرف يستطيع إصلاح شيء صغير بنفسه بدل أن يطلبه منك وينتظر. المصدر: [وثائق GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork?ref=arabroot.io).
- **الفحص الآلي قد لا يعمل فوراً:** فحوص GitHub Actions على طلب قادم من Fork قد تحتاج موافقة يدوية من مشرف قبل أن تعمل، بحسب إعدادات المشروع. فإذا رأيت أن الفحوص تنتظر الموافقة فهذا طبيعي، وليس خطأ منك. المصدر: [وثائق GitHub عن الموافقة على تشغيل الفحوص](https://docs.github.com/en/actions/how-tos/manage-workflow-runs/approve-runs-from-forks?ref=arabroot.io).

![شكل طلب دمج جيد: عنوان بصيغة الأمر، ثم ماذا ولماذا في جملتين، ثم كيف اختبرته، ثم Fixes ورقم البلاغ، ثم صور قبل وبعد للواجهة، ثم ما لم يكتمل، وبجانب كل جزء السؤال الذي يجيب عنه للمراجع](https://arabroot.io/content/images/2026/11/oss-first-contribution-03-pr-anatomy.webp)

كل جزء في الوصف يجيب عن سؤال سيسأله المراجع

### 8\. تعامل مع المراجعة كنقاش تقني

أغلب الطلبات الأولى تعود بطلب تغييرات Request Changes. وهذا لا يعني الرفض. فالمراجع يحمي مشروعاً سيصونه هو بعد أن تذهب أنت، وكل تعليق منه درس مجاني من شخص يعرف المشروع أكثر منك.

وطريقة الرد التي يتوقعها المشرفون:

1. **رد على كل تعليق:** نفذه وقل «Done»، أو اشرح بهدوء لماذا ترى غير ذلك. ولا تترك تعليقاً بلا رد.
2. **ادفع إلى نفس الفرع:** التعديلات الجديدة تظهر في نفس الطلب تلقائياً. فلا تغلق الطلب وتفتح طلباً جديداً، لأن النقاش كله يضيع.
3. **اتبع طلب المشروع في شكل الـ Commits:** بعض المشاريع تطلب دمج الـ Commits في واحد Squash، أو إعادة التأسيس على آخر نسخة Rebase. والفرق بينها وطريقتها في [Merge أم Rebase أم Squash؟](https://arabroot.io/articles/merge-%D8%A7%D9%85-rebase-%D8%A7%D9%85-squash-%D8%AF%D9%85%D8%AC-%D8%A7%D9%84%D9%81%D8%B1%D9%88%D8%B9-%D9%81%D9%8A-git/).
4. **اطلب المراجعة من جديد:** بعد أن تنهي التغييرات، اكتب تعليقاً قصيراً أو استخدم زر طلب المراجعة، حتى يعرف المراجع أن دوره جاء.

وإذا لم تستطع إكمال العمل لأي سبب، مثل الاختبارات الجامعية، فاكتب ذلك في الطلب. فالمشرف يفضل أن يعرف ليسلمه لغيرك، على أن يبقى الطلب معلقاً لأشهر. وقد كتبنا عن استقبال التعليقات دون دفاع في قسم [دور الكاتب في مقال مراجعة الكود](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/#respond).

### 9\. إذا لم يرد أحد: انتظر ثم ذكر بأدب

أغلب المشرفين متطوعون، أو موظفون يعملون على المشروع جزءاً من وقتهم. لذلك قد يتأخر الرد أياماً أو أسابيع.

ويقترح [دليل Open Source Guides](https://opensource.guide/how-to-contribute/?ref=arabroot.io) أن تنتظر نحو أسبوع، ثم ترد في نفس الصفحة بأدب وتذكر المراجع باسمه إن عرفته. ولا ترسل له رسالة خاصة. وإذا لم يرد أحد بعد ذلك، فابحث عن مشروع آخر أو طريقة أخرى للمساهمة بدل أن تضيع وقتك.

وإذا رفض الطلب فاسأل عن السبب، ولا تجادل. ففي الدراسة التي ذكرناها، أغلب أسباب الرفض كانت قراراً عن اتجاه المشروع، لا حكماً على مستواك.

![دورة المراجعة بعد فتح الطلب: انتظار الفحوص الآلية وقد تحتاج موافقة مشرف، ثم المراجعة، فإذا طلبت تغييرات ترد على كل تعليق وتدفع إلى نفس الفرع وتطلب المراجعة من جديد، وإذا لم يرد أحد تنتظر أسبوعاً ثم تذكر بأدب في نفس الصفحة، ثم الدمج أو الرفض مع سؤال عن السبب](https://arabroot.io/content/images/2026/11/oss-first-contribution-04-review-loop.webp)

دورة المراجعة قد تتكرر أكثر من مرة، وكلها في نفس الطلب

### 10\. بعد الدمج: حدث نسختك واختر البلاغ التالي

بعد الدمج احذف فرعك، وحدث نسختك من المستودع الأصلي حتى لا تبدأ التعديل التالي من كود قديم. والطريقة في [وثائق GitHub لتحديث الـ Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork?ref=arabroot.io).

ثم ابق في نفس المشروع للطلب الثاني. فأنت الآن تعرف طريقة تشغيله، وتعرف المراجع وما يهمه، والطلب الثاني يأخذ نصف وقت الأول. والمساهم الذي يرسل خمسة طلبات في مشروع واحد يتعلم أكثر بكثير ممن يرسل طلباً واحداً في خمسة مشاريع.

وضع الطلب المدمج في سيرتك الذاتية برابطه، بسطر يقول ماذا أصلحت وفي أي مشروع. وطريقة كتابة سطر المشروع في [كيف تستعد لمقابلة التدريب](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B3%D8%AA%D8%B9%D8%AF-%D9%84%D9%85%D9%82%D8%A7%D8%A8%D9%84%D8%A9-%D8%A7%D9%84%D8%AA%D8%AF%D8%B1%D9%8A%D8%A8-internship-%D9%88%D8%A7%D9%86%D8%AA-%D8%B7%D8%A7%D9%84%D8%A8/).

## ماذا يتوقع منك المشرفون Maintainer Expectations؟

هذا الجدول يجمع ما يتكرر في أدلة المساهمة التي ذكرناها، وما يدل عليه في عمل المشرف:

| ما يتوقعه المشرف                  | لماذا                                  | كيف تظهره                                     |
| --------------------------------- | -------------------------------------- | --------------------------------------------- |
| أنك قرأت ملف المساهمة             | وقته محدود، والإجابات مكتوبة           | اتبع شكل الـ Commit والقالب دون أن يطلب منك   |
| أنك بحثت قبل أن تسأل              | نفس السؤال يتكرر عليه كثيراً           | اذكر ما جربته وما قرأته في سؤالك              |
| طلب صغير مختبر                    | المراجعة أغلى من الكتابة               | موضوع واحد، واختبار، ووصف كامل                |
| النقاش في العلن                   | غيرك يستفيد من الإجابة، والقرار موثق   | اسأل في البلاغ أو الطلب، لا في الرسائل الخاصة |
| الصبر والأدب                      | أغلب المشرفين متطوعون                  | انتظر أسبوعاً قبل التذكير، واشكر على المراجعة |
| أن تكمل ما بدأت أو تقول إنك توقفت | البلاغ المحجوز باسمك لا يعمل عليه غيرك | اكتب «I can't continue on this» إذا توقفت     |
| أن تفهم كل سطر في طلبك            | هو من سيصون الكود بعدك                 | اشرح أي سطر إذا سئلت عنه                      |

## الذكاء الاصطناعي في المساهمة AI-assisted Contributions

كثير من المشاريع تستقبل اليوم طلبات وبلاغات مكتوبة بأدوات الذكاء الاصطناعي دون أن يفهمها مرسلها، وبعض المشرفين يعانون منها. لذلك بدأت مشاريع تكتب قواعد صريحة. ودليل المساهمة في curl مثال واضح:

- يقبل المشروع كوداً كتب بمساعدة الذكاء الاصطناعي، بشرط أن يتبع معايير الكود ويكون واضحاً وموثقاً ومعه اختبارات.
- إذا استعملت أداة ذكاء اصطناعي لتجد مشكلة أمنية فيجب أن تقول ذلك في بلاغك، وأن تتحقق من المشكلة بنفسك قبل الإرسال.
- من يرسل بلاغات مختلقة يحظر فوراً.
- وأنت مسؤول عن ترخيص كل كود ترسله، سواءً استعملت الذكاء الاصطناعي أم لا.

المصدر: [دليل المساهمة في curl](https://curl.se/dev/contribute.html?ref=arabroot.io). ويقول دليل Open Source Guides الشيء نفسه بكلمات أقل: راجع ما تنتجه الأداة بعناية، لأنك المسؤول عما ترسله.

والقاعدة العملية لك كطالب: استعمل الأداة لتفهم الكود أو لتقترح عليك اختباراً، لكن لا ترسل سطراً لا تستطيع شرحه إذا سألك المراجع عنه. واقرأ ملف المساهمة في مشروعك، فبعض المشاريع تطلب أن تذكر استخدامك للأداة في وصف الطلب، وبعضها يمنعها. والطالب الذي يرسل طلباً لا يفهمه يخسر الشيء الذي جاء من أجله، وهو أن يتعلم.

## مساهمات ليست كوداً Non-code Contributions

أول مساهمة لا يجب أن تكون كوداً. فالمشاريع تحتاج أشياء كثيرة يقل من يقدمها:

- **التوثيق:** خطوة ناقصة في دليل التثبيت وجدتها وأنت تشغل المشروع. وهي من أسهل المساهمات الأولى وأكثرها قبولاً.
- **بلاغ جيد عن خطأ:** خطوات واضحة لإعادة المشكلة، والإصدار، ونظام التشغيل، ورسالة الخطأ كاملة. فالبلاغ الجيد يوفر على المشرف ساعات.
- **الترجمة إلى العربية ومراجعتها:** وكثير من المشاريع لا تعرض العربية بشكل صحيح من اليمين إلى اليسار RTL. والمشكلات التقنية في ذلك شرحناها في [التعريب i18n للمطورين](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B9%D8%B1%D9%8A%D8%A8-i18n-%D9%88%D8%A7%D9%84%D9%86%D8%B5-%D8%AB%D9%86%D8%A7%D8%A6%D9%8A-%D8%A7%D9%84%D8%A7%D8%AA%D8%AC%D8%A7%D9%87-bidi-%D9%84%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86/) و[CSS للعربية واتجاه RTL](https://arabroot.io/articles/css-%D9%84%D9%84%D9%88%D8%A7%D8%AC%D9%87%D8%A7%D8%AA-%D8%A7%D9%84%D8%B9%D8%B1%D8%A8%D9%8A%D8%A9-%D8%A7%D9%84%D8%AE%D8%B5%D8%A7%D8%A6%D8%B5-%D8%A7%D9%84%D9%85%D9%86%D8%B7%D9%82%D9%8A%D8%A9-%D9%88-rtl/).
- **تجربة طلبات الآخرين:** شغل طلب دمج مفتوح على جهازك واكتب النتيجة. وهذا يعلمك المشروع ويساعد المشرف.

وإذا وجدت ثغرة أمنية فلا تفتح لها بلاغاً عاماً، واتبع ملف SECURITY.md في المشروع كما شرحنا في [قسم الثغرات الأمنية](https://arabroot.io/articles/%D8%AD%D9%88%D9%83%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D8%B1%D9%8A%D8%B9-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%A7%D9%87%D9%85%D8%A9-%D9%81%D9%8A%D9%87%D8%A7/#security-reports).

## أخطاء شائعة Common Mistakes

- **البدء دون تعليق في البلاغ:** ثم تجد أن غيرك أرسل الإصلاح قبلك بيومين، وهو السبب الأشهر للرفض.
- **العمل على بلاغ مسند لغيرك:** دون أن تسأل هل ما زال يعمل عليه.
- **طلب كبير في أول مرة:** ميزة جديدة كاملة لم يناقشها أحد، فتنتظر أسابيع ثم ترفض لأنها لا تناسب رؤية المشروع.
- **تعديل التنسيق مع الإصلاح:** فيصبح الفرق مئات الأسطر، ولا يجد المراجع تعديلك.
- **تجاهل الفحص الآلي الفاشل:** المشرف لن يراجع طلباً فحوصه حمراء. فاقرأ سبب الفشل وأصلحه أولاً.
- **فتح طلب جديد بعد كل مراجعة:** فيضيع النقاش، ويضطر المراجع أن يبدأ من الصفر.
- **الإلحاح في الرسائل الخاصة:** أو التذكير كل يوم.
- **طلبات تافهة لزيادة العدد:** تعديل مسافة واحدة في عشرة طلبات. فالمشرفون يعرفون هذا النوع، وبعضهم يغلقه دون رد.
- **إرسال كود من أداة ذكاء اصطناعي لا تفهمه:** ثم عدم القدرة على الإجابة عن سؤال المراجع.

## قائمة تحقق Checklist قبل أن ترسل طلبك

| المرحلة   | تأكد من                                                                                                  |
| --------- | -------------------------------------------------------------------------------------------------------- |
| قبل الكود | المشروع حي، وقرأت CONTRIBUTING.md، والبلاغ غير مسند ولا طلب مرتبط به، وكتبت فيه تعليقاً بخطتك            |
| على جهازك | المشروع واختباراته تعمل قبل التعديل، وأعدت المشكلة وكتبت خطواتها                                         |
| التعديل   | موضوع واحد، بأسلوب المشروع، ومعه اختبار، ورسالة Commit بالشكل المطلوب، وتوقيع إن طلبه المشروع، ولا أسرار |
| الطلب     | عنوان واضح، وماذا ولماذا، وكيف اختبرته، وFixes ورقم البلاغ، وصور إن كانت واجهة                           |
| المراجعة  | رددت على كل تعليق، ودفعت إلى نفس الفرع، وطلبت المراجعة من جديد                                           |
| بعد الدمج | حذفت الفرع، وحدثت نسختك، وأضفت الرابط إلى سيرتك، واخترت البلاغ التالي في نفس المشروع                     |

## الخلاصة Summary

- أشهر سببين لرفض المساهمات الأولى هما التكرار واختلاف الرؤية، وكلاهما يمنعه تعليق في البلاغ قبل أن تبدأ.
- البلاغ المفتوح بوسم المبتدئين ليس بالضرورة متاحاً، فتحقق من الإسناد والطلبات المرتبطة وآخر التعليقات.
- شغل المشروع واختباراته قبل التعديل، واجعل التعديل صغيراً في موضوع واحد ومعه اختبار.
- الوصف الجيد يجيب عن أسئلة المراجع قبل أن يسألها: ماذا ولماذا وكيف اختبرته.
- المراجعة نقاش في نفس الطلب، والصبر أسبوع قبل التذكير.
- أنت مسؤول عن كل سطر ترسله، فلا ترسل ما لا تستطيع شرحه.

والخطوة التالية في هذه المرحلة اختيار مشروع تبقى فيه، ثم برامج المساهمة المدفوعة للطلاب مثل [Google Summer of Code](https://summerofcode.withgoogle.com/?ref=arabroot.io) و[Outreachy](https://www.outreachy.org/?ref=arabroot.io)، وكلاهما يطلب عادة مساهمات سابقة في المشروع قبل القبول. وأقرب المقالات إلى هذا الموضوع:

[![](https://arabroot.io/content/images/2026/10/oss-governance-cover-cover.webp)دليلمن يدير المشروع مفتوح المصدر؟ نماذج الحوكمة Governanceمن يقرر في مشروع يساهم فيه آلاف الأشخاص، ومن يستطيع تغيير رخصته، وما الذي تفحصه قبل أن تعتمد على أي مشروع.](https://arabroot.io/articles/%D8%AD%D9%88%D9%83%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D8%B1%D9%8A%D8%B9-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%A7%D9%87%D9%85%D8%A9-%D9%81%D9%8A%D9%87%D8%A7/)[![](https://arabroot.io/content/images/2026/10/open-source-licenses-cover-cover.webp)دليلما هي البرمجيات مفتوحة المصدر؟ القصة وأشهر الرخصكيف بدأت البرمجيات الحرة والمفتوحة، وما الفرق بين الحر والمجاني، وكيف تعرف ما تسمح به رخصة أي مشروع قبل أن تبني عليه.](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%8A-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D9%8A%D8%A7%D8%AA-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%AA%D8%B1%D8%A7%D8%AE%D9%8A%D8%B5%D9%87%D8%A7/)[![](https://arabroot.io/content/images/2026/11/code-review-basics-cover-cover.webp)دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/)[![](https://arabroot.io/content/images/2026/11/git-basics-cover-cover.webp)دليلإدارة النسخ مع Git للمبتدئين: لماذا نحتاجها وكيف تعمللماذا تضيع الملفات بأسماء final\_v2 ويمسح الزملاء عمل بعضهم، وكيف يحل Git ذلك على مشروع حقيقي من أول commit.](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D9%88-git-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/11/git-first-repo-cover-cover.webp)دليلأول مستودع Git لك: من git init إلى أول push على Giteaخطوة بخطوة من مجلد مشروع على جهازك إلى مستودع على Gitea، مع مفاتيح SSH ورموز الوصول والأخطاء التي سوف تراها في أول مرة وكيف تقرؤها.](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-git-%D9%84%D9%83-%D9%85%D9%86-git-init-%D8%A7%D9%84%D9%89-%D8%A7%D9%88%D9%84-push-%D8%B9%D9%84%D9%89-gitea/)[![](https://arabroot.io/content/images/2026/11/git-merge-rebase-cover-cover.webp)دليلMerge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوةثلاث طرق لإدخال عمل فرعك إلى main، نجربها على المستودع نفسه حتى ترى بعينك ماذا تفعل كل واحدة بالتاريخ، ومتى تختارها، وكيف تحل التعارض في كل منها.](https://arabroot.io/articles/merge-%D8%A7%D9%85-rebase-%D8%A7%D9%85-squash-%D8%AF%D9%85%D8%AC-%D8%A7%D9%84%D9%81%D8%B1%D9%88%D8%B9-%D9%81%D9%8A-git/)[![](https://arabroot.io/content/images/2026/10/secrets-scanning-cover-cover.webp)دليلSecrets Scanning: كيف تكتشف الأسرار المسربة في الكودكيف يخرج المفتاح من جهازك إلى تاريخ Git وخط CI، وكيف تكتشفه قبل غيرك، وماذا تفعل في الساعة الأولى بعد تسربه.](https://arabroot.io/articles/%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%A7%D9%84%D9%85%D8%B3%D8%B1%D8%A8%D8%A9-%D9%85%D8%B9-gitleaks-%D9%88-trufflehog/)[![](https://arabroot.io/content/images/2026/10/prepare-internship-interview-cover-cover.webp)دليلكيف تستعد لمقابلة التدريب Internship وأنت طالب؟سيرة ذاتية بلا خبرة عمل، ومشاريع تبنيها لمسار التطوير والأمن، وإجابات لأسئلة مقابلة التدريب الشائعة، وأسئلة تسألها أنت.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B3%D8%AA%D8%B9%D8%AF-%D9%84%D9%85%D9%82%D8%A7%D8%A8%D9%84%D8%A9-%D8%A7%D9%84%D8%AA%D8%AF%D8%B1%D9%8A%D8%A8-internship-%D9%88%D8%A7%D9%86%D8%AA-%D8%B7%D8%A7%D9%84%D8%A8/)[![](https://arabroot.io/content/images/2026/11/oss-find-project-cover-cover.webp)دليلكيف تختار مشروعاً مفتوح المصدر تساهم فيه وتبقى؟كيف تختار مشروعاً مفتوح المصدر يناسبك وتتأكد أنه حي قبل أن تبدأ، ثم تبقى فيه، بأرقام جمعناها من GitHub عن بلاغات المبتدئين وطلبات الدمج.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%AE%D8%AA%D8%A7%D8%B1-%D9%85%D8%B4%D8%B1%D9%88%D8%B9%D8%A7-%D9%85%D9%81%D8%AA%D9%88%D8%AD-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-open-source-%D8%AA%D8%B3%D8%A7%D9%87%D9%85-%D9%81%D9%8A%D9%87-%D9%88%D8%AA%D8%A8%D9%82%D9%89/)[![](https://arabroot.io/content/images/2026/11/student-oss-programs-cover-cover.webp)دليلبرامج المساهمة المدفوعة للطلاب: GSoC وOutreachy وLFXشروط Google Summer of Code وLFX Mentorship وOutreachy وMLH Fellowship ومكافآتها لمن يقيم في السعودية ومواعيدها، وكيف تساهم وتكتب مقترحاً يقبل.](https://arabroot.io/articles/%D8%A8%D8%B1%D8%A7%D9%85%D8%AC-%D8%A7%D9%84%D9%85%D8%B3%D8%A7%D9%87%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D8%AF%D9%81%D9%88%D8%B9%D8%A9-%D9%84%D9%84%D8%B7%D9%84%D8%A7%D8%A8-gsoc-%D9%88-outreachy-%D9%88-lfx/)

## سجل التحديثات Changelog

- 2026-11-14: كتابة المقال، وجمع أرقام البلاغات المفتوحة بوسم المبتدئين في ستة مشاريع من واجهة البحث في GitHub، والتحقق من صفحات GitHub وcurl وOpen Source Guides والدراستين المذكورتين في نفس اليوم.