اختيار كاتب فني
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرحلة الحالية:
انتهى برنامج "موسم المستندات" لعام 2021 في 14 كانون الأول (ديسمبر) 2021. اطّلِع على
المخطط الزمني.
تحتوي هذه الصفحة على نصائح لمنظمات البرامج المفتوحة المصدر حول كيفية تقييم و
اختيار الكاتب الفني المناسب لاقتراح مشروع "موسم مستندات Google".
مقدمة
على المؤسسات التي تستخدم البرامج المفتوحة المصدر توظيف كاتب فني للعمل على مشروعها المقترَح. على المؤسسات الاستعانة بكاتب فني خاص بها.
يمكن العثور على الكتاب التقنيين المهتمين بالعمل مع المؤسسات المشاركة في "موسم مستندات Google" في مستودع GitHub الخاص بـ "موسم مستندات Google"، وفي قناة#season-of-docs في مجموعة Write the Docs على Slack.
تقييم كاتب محتوى تقني
ننصحك بطلب أمثلة على المستندات التي تم تطويرها سابقًا
من الكتاب الفنيين الذين تفكر في الاستعانة بهم، حتى تتمكّن من التركيز على
تقييم مهاراتهم وخبراتهم في الكتابة الفنية.
مهارات الكتابة الفنية والخبرة
الاطّلاع على خبرة الكاتب التقني السابقة:
من الأفضل أن يمتلك الكاتب الفني بعض الخبرة السابقة في كتابة مستندات فنية
لصناعة البرامج. أحد أهداف "موسم المستندات" من Google هو منح الكتاب الفنيين فرصة المشاركة في تطوير المنتجات التي تركّز على المطوّرين. لهذا السبب، ليس من الضروري أن يكون لدى
الكاتب خبرة في واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) أو منصات المطوّرين الأخرى، حتى إذا كان
مشروعك يركّز على جمهور المطوّرين.
ركِّز على اللغة ومهارات التواصل.
قيِّم عمل الكاتب الفني السابق من هذه الناحية. الأهم هو: هل يمكنك فهم ما كتبه المستخدم؟ إذا كنت تريد إجراء مراجعة عميقة للغة عمل الكاتب الفني، ابحث عن اتساق في علامات الترقيم والصياغة والإملاء الصحيح واللغة الواضحة.
هل الصياغة بسيطة أم معقّدة؟ هل الجمل قصيرة أم طويلة ويصعب متابعتها؟
التركيز على تصميم المستند وتنسيقه:
تحقَّق من التنسيق العام لعينات المستندات. هل التصميم منطقي؟ هل يمكن
لك التنقّل بسهولة في المستند أو مجموعة المستندات؟ هل هناك
تكرار في المحتوى أو فجوات واضحة؟
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-01-06 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This documentation is specifically for the 2021 Season of Docs program, which concluded on December 14, 2021."],["Open source organizations participating in Google Season of Docs are responsible for finding and hiring their own technical writers."],["When assessing technical writers, prioritize their technical writing skills and experience by reviewing prior work samples, focusing on language clarity, communication skills, and document design."],["While prior experience in technical writing for software is ideal, it's not crucial for the writer to have specific experience with APIs, SDKs, or other developer platforms."],["Organizations can find potential technical writers through resources like the Google Season of Docs GitHub repository and the Write the Docs Slack channel."]]],["Open source organizations must hire a technical writer for their project, sourcing them independently. Potential writers can be found in the program's GitHub repo and Write the Docs Slack channel. Organizations should assess candidates' prior documentation, focusing on technical writing skills, language proficiency, and communication clarity. They should also examine document design, layout, and organization, looking for consistency, logical structure, and ease of navigation. Experience writing technical documentation is recommended.\n"]]
