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