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