تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

اختيار المقاييس المناسبة لمشروعك

يهدف هذا الدليل إلى مساعدة المؤسسات في فهم أنواع المشاكل التي يمكن حلّها من خلال توثيق أفضل، وكيفية اختيار المقاييس المناسبة لمشاريع التوثيق.

المرحلة الحالية:
تم نشر دراسات الحالة. اطّلِع على المخطط الزمني.

توضيح المشكلة

قبل اختيار مقياس، تأكَّد من أنّ لديك فهمًا جيدًا للمشكلة التي تحاول حلّها. يُرجى توفير أكبر قدر ممكن من التفاصيل.

"يستغرق دمج طلبات سحب مستندات الإعداد وقتًا طويلاً جدًا. يتخلّى المساهمون عن الترجمة ويغادرون الموقع الإلكتروني".
"لقد فتحنا عددًا كبيرًا من المشاكل للحصول على مساعدة في فهم رموز الخطأ".
"مسار التكامل/النشر المستمر لدينا غير مستقر. وتُفشل الكثير من الاختبارات لأسباب غير معروفة جيدًا.
"يبدو أنّ الموظفين ينزعجون في اجتماعاتنا الأسبوعية".

ابحث عن السبب والنتيجة. ما هو السبب المحتمل للمشكلة التي ذكرتها؟ يُرجى العِلم أنّ المشاكل قد يكون لها أسباب متعدّدة أو متداخلة.

"يستغرق دمج طلبات الجذب الخاصة بمستندات الإعداد وقتًا طويلاً، لأنّنا لا نملك إرشادات واضحة حول الأسلوب. إما أن يؤجل المراجعون مراجعة طلب الدمج لأنّهم لا يعرفون ما يجب فعله، أو يتواصلون مجددًا مع المساهمين بشأن التنسيق".
"على المستخدمين فتح المشاكل لأنّه لا يمكنهم العثور على معلومات عن رموز الخطأ في المستندات".
"تتعذّر إكمال اختبارات التطوير والتكامل المستمرَين بسبب قيود الخطة والمهلات التي يفرضها مزوّدنا".
"يكون الموظفون غاضبين في اجتماعاتنا الأسبوعية لأنّ الاجتماعات تبدأ عند الساعة 5:30 صباحًا في منطقتهم الزمنية".

هل هذه مشكلة يمكن حلّها من خلال مستندات جديدة أو أفضل؟

"إذا كان لدينا دليل أسلوب، يمكن للمشاركين التحقّق منه قبل إرسالهم طلبات إعادة النظر. سيعرف المراجعون ما الذي عليهم التحقّق منه. لن يحتاج المُراجعون والمُساهمون إلى الجدال حول التنسيق والأسلوب واللغة".
"إذا كانت لدينا مستندات حول رموز الأخطاء، يمكن للمستخدمين العثور على الإجابات هناك، بدلاً من فتح المشاكل".
"لا يبدو أنّ التوثيق الأفضل سيحلّ مشكلة التكامل المستمر/النشر المستمر."
"يمكننا بدء كل اجتماع بمزحة من نوع "بابا حكّم". سيساعدنا إنشاء مجموعة من النكات المضحكة في بدء اجتماعاتنا بابتسامة".

هل يمكنك تحديد المشكلة كميًا؟

"ما المقصود حقًا بعبارة "يستغرق دمج الطلبات البرمجية وقتًا طويلاً جدًا"؟ شهران؟ هل يمكنني الانتظار أسبوعين؟ ما هي المدة التي سينتظرها المساهمون قبل الاستسلام؟"
"ما هو عدد المشاكل المرتبطة برمز الخطأ التي تُعدّ "مشاكل كثيرة جدًا"؟"
"حسنًا، ما هو مستوى الغضب الذي تقصده؟"

كيف يمكنك التحقّق من المقياس المقترَح؟ هل يمكن قياسه بسهولة وبدقة؟ هل يعتمد القياس على الشخص الذي يجريه؟

"يمكننا بسهولة قياس المدة التي ظل فيها طلب الدمج مفتوحًا، والمدة التي مرت منذ طلب إجراء مراجعة. لا يمكننا قياس الوقت الدقيق الذي يتوقف فيه أحد المساهمين عن المحاولة".
"يمكننا احتساب عدد المشاكل التي تم وضع علامة "رمز الخطأ" عليها أو البحث في المشاكل عن نص رمز الخطأ".
"لا يمكننا قياس مدى انزعاج المستخدمين بطريقة لبقة أو دقيقة".

هل هناك مقاييس أخرى يمكن أن تساعدك في معرفة ما إذا كانت مستنداتك تحلّ مشكلتك؟ هل المقياس المستهدَف هو نفسه في كل حالة؟

"تستغرق طلبات الدمج الأطول وقتًا أطول للمراجعة، لذا يجب أن يكون لدينا حدود مختلفة لمختلف أحجام طلبات الدمج. نريد قياس وقت الدمج لطلبات إعادة النظر الصغيرة والمتوسطة والكبيرة والضخمة".
"يمكننا التحقّق من عدد الزيارات التي تتلقّاها مستندات رموز الأخطاء ومحاولة معرفة ما إذا كان هذا العدد مرتبطًا بانخفاض عدد المشاكل التي تم فتحها".

"نعتقد أنّ أسبوعَين هو وقت معقول لدمج طلبات الدفع الصغيرة أو المتوسطة الحجم، ومن المفترض أن يتم دمج جميع طلبات الدفع في غضون شهر. سنقيسها كل شهرين".
"لا داعي لتعديل عدد المشاكل المتعلّقة برموز الأخطاء يوميًا، لأنّ الوقت المعتاد لإغلاق مشكلة هو أسبوع واحد. سنقيسه أسبوعيًا".

ما هو مقدار التغيير الذي يجب أن تلاحظه في المقياس المحدّد للقول بأنّ المشروع كان ناجحًا؟ ننصحك بتحديد أهداف كمية للمقاييس التي اختَرتها.

"إذا حقّقنا هدفنا المتمثل في إغلاق كل حملة علاقات عامة جديدة في أقل من شهر، سيكون ذلك نجاحًا. إذا انخفض متوسط الوقت اللازم لإغلاق طلبات الدعم الكبيرة بمقدار أسبوعَين، سيكون ذلك نجاحًا كبيرًا".
"من المفترض ألا تظهر أي مشاكل جديدة متعلقة بالأخطاء. ولكننا سنعتبر أنّ مشروعنا ناجح إذا شهدنا انخفاضًا بنسبة% 50 في عدد المشاكل المتعلقة بالأخطاء التي تم فتحها".

يمكنك الاطّلاع على دليل مشرف المؤسسة للحصول على مساعدة بشأن المهام المتعلّقة بالتقارير.