المرحلة الحالية:
تم الإعلان عن النتائج
المخطط الزمني.
في ما يلي بعض الإرشادات لمساعدة مؤسسات البرامج المفتوحة المصدر في العمل بفعالية مع الكتّاب التقنيين.
تعريف الكاتب التقني بعالم البرامج المفتوحة المصدر والمنتدى لديك
- منح الكاتب التقني "جولة إرشادية" في المنتدى الخاص بك أين يمكنهم طرح الأسئلة؟ ما الاجتماعات المنتظمة التي يجب أن يحضرها، أو ما القوائم البريدية التي يجب عليه الانضمام إليها؟ ما هي الحسابات التي يحتاج إليها (GitHub أو Discord أو Slack)؟ تأكد من فهمهم لقواعد السلوك الخاصة بمشروعك ومعرفة كيفية الإبلاغ عن أي مشكلات. تأكد من أن الكاتب الفني يفهم ترخيص مشروعك، ويلتزم بأي متطلبات لأصحاب العمل الآخرين بشأن توقيع اتفاقيات ترخيص المحتوى أو اتفاقيات شراكة الأعمال أو الاتفاقيات الأخرى.
- إن أمكن، عرّفهم على عدد قليل من الأشخاص في المناطق الزمنية المتداخلة الذين يمكنهم الرد بسرعة على الأسئلة حول المجتمع أو المشروع.
- إذا كان بإمكانك، أرسل لهم بعض الهدايا الترويجية للمشروع!
ساعد الكاتب التقني في استخدام الأدوات والعمليات المتضمنة في المساهمة في مشروعك
- إذا لم تكن العمليات موثَّقة جيدًا، يمكنك تحديد موعد لإطلاع الكاتب التقني على أول مساهمة أو مشكلة أو طلب سحب أول. ما القوالب أو العلامات التي يجب أن يستخدمها؟ من يحتاج إلى مراجعة مساهماته، وكيف ومتى يجب متابعة المراجعات؟ إذا كان عملهم يتضمن عينات من التعليمات البرمجية، فكيف يمكن اختبارها؟ ما الذي يحتاجون إلى معرفته حول عملية CI/CD أو الإصدارات؟
مساعدة الكاتب التقني في فهم مشروعك ومستخدميه
- اشرح مشروعك بالتفصيل حتى يكتسب الكاتب الفني فهمًا مفاهيمي راسخًا للمنتج. حيث يمكن أن يساعد ذلك الكاتب التقني في الشعور بمزيد من الثقة وموثوقية أكبر في كتاباته المتعلقة بالمشروع.
- وصف احتياجات الأشخاص الذين يستخدمون المشروع. كن محددًا قدر الإمكان - ليس فقط "المطورون" ولكن "المطورون الذين ينشئون مواقع ويب" و"المطورون الذين يبرمجون الروبوتات الصناعية".
- جعل الكاتب التقني على اتصال بالخبراء المختصين في الموضوع. أي، المطورين أو المساهمين الآخرين في المشروع المسؤولين عن جوانب مشروعك التي ستتناولها الوثائق.
- التأكد من حصول الكاتب التقني على الوقت والموارد التي يحتاجها من الخبراء المختصين وأي أعضاء آخرين في المنتدى.
طرح الأسئلة
- ربما لم يعمل المنتدى أو المشروع مع الكتاب الفنيين أو المساهمين في الوثائق من قبل. اغتنم الفرصة للتعلم أثناء مشاركة ما تعرفه! اطلب ملاحظات حول عملياتك وأدواتك - من المحتمل أن يكون لدى الكاتب التقني بعض الاقتراحات للتحسين.