شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات بكل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم/ة" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشيفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. صفحة المجتمع خاصتنا تعطي ملخصا للطرق المختلفة التي يمكن بها المشاركة والمساهمة معنا.
هذا المشروع يتبع المواصفات القياسية لمشروع all-contributors "كل المساهمين". نحن نستعمل البوت @all-contributors كي نضيف المساهمين/ات إلى الملف README.md. يمكنك الطلب من البوت @all-contributors أن يضيفك عن طريق كتابة الآتي في تعليق على طلب مشكلة "issue" على جيت هب "GitHub" أو طلب سحب"pull request" :
@all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك]
يمكنك معرفة نوع مساهمتك المناسب من هنا، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على موقع p5.js ومُستضاف على مستودع "repository" جيت هب الخاص بـ p5.js.
المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء كانت إصلاح خطأ مطبعي بسيط أو إعادة هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب معرفتها وفهمها قبل البدء في المساهمة.
بدايةً: من فضلك قم/قومي بقراءة بيان مجتمعنا
أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين/ات) لـ p5.js! للمزيد من التفاصيل، يمكنك إلقاء نظرة على بيان الإتاحة خاصتنا
الآن أنت على استعداد لبدء المساهمة في p5.js! هناك العديد من الطرق لبدء المساهمة إلى p5.js وأيضا العديد من الأسباب للمساهمة معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين:
- المساهمات التي تتعامل بشكل مباشر مع الشيفرة المصدرية (هذا يتضمن التوثيق البرمجي)
- المساهمات التي قلما تتعامل مع الشيفرة المصدرية أو لا تتعامل مها على الإطلاق
على حسب نوع المساهمة المراد القيام بها إلى p5.js، يمكنك قراءة الجزء المناسب من هذا الدليل.
للقيام بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، يجب إتباع الخطوات الآتية:
- عمل طلب مشكلة على جيت هب
- مناقشة طلب المشكلة
- الحصول على موافقة لعمل بطلب سحب
- تغيير الشيفرة المصدرية
- عمل طلب سحب
- مناقشة طلب السحب
- الموافقة على طلبك وضمه
في هذه الصفحة، سيتم توجهيك خطوة بخطوة لتنفيذ الخطوات المذكورة أعلاه، يمكنك استعمال فهرس تلك الصفحة للوصول إلى الأجزاء المراد مراجعتها أو تذكرها.
معظم الوقت سنسير بحزم على خطة العمل هذه، قد يصلك شعور بأننا نقوم بالعديد من المناورات من أجل ما يبدو مساهمة بسيطة، وبخاصة إذا قمت بالمساهمة في مشاريع أخرى. رغم ذلك، فإننا نهدف بالخطوات المذكورة أعلاه بأن نسهل عليك كمساهم/ة أو كمتعهد/ة أوكمشرف/ة المساهمة بشكل هادف ذو معنى، وفي نفس الوقت نحرص على ألا يضيع وقتك في عمل قد يُرفض لأسباب كثيرة. الخطوات أعلاه تساعد في ضمان أن كل اقتراح أو إصلاح قد نوقش بشكل وافٍ قبل البدء في تنفيذه، مما سيوفر عليك (والمتعهدين/ات والمشرفين/ات) الوقت، حيث ستقل طلبات السحب التي تتطلب المزيد من التعديلات بعد مراجعتها، أو الإصلاحات المرفوضة من البداية بشكل صريح.
نحن نرى المساهمة إلى p5.js كفرصة للتعلم ولا نقيس النجاح بعدد المساهمات التي تصلنا. لا توجد مهلة تَحدُك لتنفيذ مساهمتك، لذا يمكنك اتخاذ الوقت والسرعة المناسبة لك (قد نراسلك إذا غبت لفترة طويلة). يمكنك سؤال المتعهدين/ات أو المشرفين/ات إذا احتجتهم وسوف نبذل قصارى جهدنا حتى نساعدك.
هناك العديد من الطرق للمساهمة إلى p5.js بعيدا عن الشيفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد تكون لدينا القدرة على مساعدتك بطرق عدة، لذا يمكنك التواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ).
للدليل الخاص بالمتعهدين/ات أو الصيانة العامة لمستودع p5.js على جيت هب، يمكنك إلقاء نظرة على دليل المتعهدين