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