المرحلة الحالية:
تم الإعلان عن النتائج
المخطط الزمني.
تحتوي هذه الصفحة على نصائح لمؤسسات البرامج مفتوحة المصدر حول كيفية تقييم واختيار الكاتب التقني المناسب لاقتراح مشروع Season of Docs.
مقدمة
يجب على مؤسسات البرامج المفتوحة المصدر تعيين كاتب تقني للعمل في المشروع المقترح. يجب أن تحصل المؤسسات على كاتبها التقني. ويمكن العثور على الكتّاب التقنيين المهتمين بالعمل مع المؤسسات المشاركة في Season of Docs في موقع Season of Docs GitHub، وفي قناة#Season-of-docs في قائمة "كتابة المستندات" في Slack.
بدء العملية
ننصحك ببدء عملية العثور على كاتب تقني في أقرب وقت تعتقد أنّه قد يهمك المشاركة في Season of Docs.
تقييم كاتب تقني
يُوصى بطلب أمثلة عن الوثائق التي تم تطويرها سابقًا من الكُتّاب التقنيين الذين تفكر فيهم، حتى تتمكن من التركيز على تقييم مهاراتهم وخبراتهم الفنية في الكتابة.
مهارات وخبرة الكتابة التقنية
الاطّلاع على الخبرة السابقة للكاتب التقني من الناحية المثالية، يجب أن يكون للكاتب التقني بعض الخبرة السابقة في كتابة الوثائق التقنية لصناعة البرمجيات. يتمثل أحد أهداف Season of Docs في منح الكتّاب التقنيين الفرصة للمشاركة في المنتجات التي تركز على المطورين. لهذا السبب، ليس من الضروري أن يكون للكاتب خبرة في واجهات برمجة التطبيقات أو حزم SDK أو منصات المطورين الأخرى، حتى إذا كان مشروعك يركز على جمهور المطورين.
ركِّز على مهارات اللغة والتواصل. قم بتقييم العمل السابق للكاتب التقني من هذه وجهة النظر. والأهم من ذلك: هل يمكنك فهم ما كتبه الشخص؟ إذا كنت تريد إجراء مراجعة متعمقة للغة عمل الكاتب التقني، فابحث عن الاتساق في علامات الترقيم والصياغة، والتهجئة الصحيحة، واللغة الواضحة. هل الصياغة بسيطة أم معقدة؟ هل الجمل قصيرة أم تستمر حتى يصبح من الصعب اتباعها؟
الانتباه إلى تصميم المستندات وتنسيقها: تحقق من التنسيق العام لنماذج المستند. هل التصميم منطقي؟ هل يمكنك أن تجد طريقك بسهولة حول المستند أو مجموعة الوثائق؟ هل هناك تكرار للمحتوى أو هل هناك فجوات واضحة؟
الاستعانة بكاتب تقني
على المؤسسات الاستعانة بكاتب فني وإكمال نموذج إثبات توظيف المؤلفين الفنيين على الرابط أدناه بحلول 16 أيار (مايو) 2022 عند الساعة 18:00 بالتوقيت العالمي المنسّق.
اكتملت مرحلة توظيف الكاتب التقني.
احرص على مناقشة التعويض وجدول الدفع مع الكاتب التقني قبل التوظيف. نوصي المؤسسات بوضع جدول دفع مع الكتاب الفنيين بناءً على المعالم الرئيسية للمشروع، بما في ذلك الدفع عند بدء المشروع. يرجى مراعاة تواريخ الدفع، والتي لن تحدث إلا مرتين خلال البرنامج، والمبالغ عند إنشاء جدول الدفع.
ملاحظة: إنّ المؤسسات التي لم توظف كاتبًا في مجال التكنولوجيا ولم تقدّم نموذج إثبات توظيف الكتّاب الفنيين بحلول 16 أيار (مايو) 2022 في الساعة 18:00 حسب التوقيت العالمي المنسَّق، لن تتلقّى مبالغ مالية في تاريخ تسديد الدفعة الأولى.