إرشادات المساهمة

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

يشرح الملف كيف يمكن لأي شخص المشاركة في أنشطة مثل تنسيق التعليمات البرمجية لإرسالها أو إرسال التصحيحات . [ 1 ]

يُفترض أن يزيد وجود الملف في حزمة ما من فرص حصول المشروع على مساهمات جماعية. [ 2 ] ولكن في كثير من الحالات، لا تلتزم المساهمات المُستلمة بالتعليمات الواردة في الملف. [ 3 ]

إن وجود ملف للمساهمات يساهم بشكل كبير في نجاح المشاريع التي تعتمد على مساهمات المستخدمين. [ 4 ]

مراجع

  1. بارنز، كيفن ر. (17 سبتمبر 2012). "إرشادات المساهمة" . مدونة جيت هاب . جيت هاب.
  2. كوباياكاوا، ناوكي؛ يوشيدا، كينيتشي (2017). "كيف يُسهم ملف Contributing.md الخاص بـ GitHub في دعم المساهمين". المؤتمر السنوي الحادي والأربعون لبرمجيات وتطبيقات الحاسوب (COMPSAC) لعام 2017. الصفحات 694-696 . doi : 10.1109/COMPSAC.2017.139 . ISBN  978-1-5386-0367-3. S2CID 156171 . 
  3. إيلزهاري، عمر؛ ستوري، مارغريت آن ؛ إرنست، نيل؛ زايدمان، آندي (6 أغسطس 2019). "افعلوا كما أفعل، لا كما أقول: هل تتوافق إرشادات المساهمة مع عملية المساهمة في GitHub؟". arXiv : 1908.02320 [ cs.SE ].
  4. كويلو، جايلتون؛ فالينتي، ماركو توليو (2017). "لماذا تفشل مشاريع المصادر المفتوحة الحديثة؟". وقائع الاجتماع المشترك الحادي عشر لعام 2017 حول أسس هندسة البرمجيات - ESEC/FSE 2017. الصفحات 186-196 . arXiv : 1707.02327 . doi : 10.1145/3106237.3106246 . ISBN  9781450351058. S2CID 12302770 .