Your first contribution can be small.

Read before changing

Read the README and contribution guide. Check which version and platform the project supports, how it is run locally, and what checks a contributor should complete. Look through existing issues before opening another one.

An unclear instruction, a missing example, or a reproducible bug can be a useful starting point. For a substantial change, discuss the scope with the maintainers first.

Make the change easy to review

Follow the repository's contribution workflow. Work on a focused branch, keep the change small, and run the checks relevant to what you changed. Include the steps needed to reproduce a bug and verify a fix.

For a documentation change, test the instructions themselves. For an interface change, check keyboard use and the layouts and languages it affects. Explain the result with a short before-and-after example.

Explain the purpose

A pull request should say what problem it solves, how behavior changes, and how it was checked. Mention limitations plainly. Review is a conversation: be ready to adjust the proposal as more context becomes available.

اقرأ قبل أن تغيّر

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

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

اجعل التغيير سهل المراجعة

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

عند تعديل التوثيق، جرّب التعليمات نفسها. وعند تعديل الواجهة، راجع لوحة المفاتيح والمقاسات واللغات المتأثرة. اشرح النتيجة بمثال قصير يوضح ما قبل التغيير وما بعده.

اشرح الغرض

ينبغي أن يوضح Pull Request المشكلة التي يعالجها، وكيف تغيّر السلوك، وكيف تحققت منه. اذكر الحدود بصراحة. المراجعة حوار؛ كن مستعدًا لتعديل الاقتراح عندما تظهر معلومات إضافية.