ونحن ننظر في مقاييس تطوير ودعم الوثائق. تقرير ياندكس

في الجزء الأول من التقرير ، أوضحنا كيفية قياس جودة الوثائق وفعالية تطويرها. الغوص الآن في تفاصيل عد المقاييس.

يقول يوري نيكولين ، رئيس دائرة تطوير الوثائق التقنية.

للبدء ، دعونا نحدد ما هو الأداء. بالمعنى الكلاسيكي ، هذا هو الوقت المستغرق لإنتاج وحدة الإخراج أو كمية الإنتاج المنتجة لكل وحدة زمنية .

على سبيل المثال ، هذا هو عدد الهواتف التي يتم إنتاجها شهريًا أو مقدار الوقت اللازم لإنتاج آلاف الهواتف. السؤال الذي يطرح نفسه هو كيفية قياس العمل الفكري الذي تشارك فيه إدارتنا.

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

لقد حددنا عدة معايير لاختيار المقاييس:

1. الشفافية. يجب أن يكون النهج المتبع في حساب المقاييس وتفسير النتائج واضحًا ليس فقط لنا ، ولكن أيضًا للعملاء.
2. توافر البيانات. بما في ذلك البيانات لأي فترة سابقة من أجل طرح فرضيات ومحاولة تأكيدها بالبيانات التاريخية.
3. القدرة على أتمتة العد. بالتأكيد لا نريد حساب المقاييس يدويًا.

نتيجة لذلك ، أدركنا أن الكائن المثالي لحساب مقاييس الأداء هو المهمة في Tracker. يلبي جميع المتطلبات التي وضعناها للمقاييس.

مصدر البيانات بالنسبة لنا كان Yandex.Tracker. أنها مرنة للغاية وقابلة للتخصيص بسهولة لمهامنا. لديها بالفعل جميع البيانات اللازمة ، لأننا نستخدم هذه الأداة كل يوم. ويحتوي Tracker أيضًا على API ، مما يعني أنه يمكنك استخدام هذه المعلومات وأتمتة العمليات.

لذلك كان لدينا خطة لكيفية المضي قدما.

إعداد قوائم الانتظار والمهام

يجب أن تبدأ باختيار قوائم الانتظار ، التسلسل الهرمي للمهام ، أنواعها وحالتها.

تم وصف ذلك بالتفصيل من قبل Katya Kunenko في تقرير " أدوات لإعداد وثائق المستخدم ". سنتحدث بإيجاز عن قائمة الانتظار والمهام التي نستخدمها لأنفسنا.

طوابير

لدينا ثلاثة خطوط ، والتي تعكس في جوهرها جمهورنا المستهدف.

تسلسل هرمي المهام

مهامنا لها هيكل من مستويين:

• في المستوى الأعلى ، تتوافق المهام مع المستندات المنشورة ،
• في المستوى السفلي ، تتوافق المهام مع العمل في المستند.

أنواع وحالات المهام

لا تسمح لنا أنواع وحالات المهام بتصنيف أنواع العمل وحالتها الحالية فحسب ، بل أيضًا النظر في مقاييسنا مع الأقسام.

الجدول الزمني لاستكمال المهام. الخط الأزرق هو متوسط ​​وقت إنتاج الوثيقة ، والبرتقال هو الوقت المناسب لإصلاح الخلل ، والأخضر هو متوسط ​​الوقت لإكمال المهام بجميع أنواعها.

سنقول على مثال للرسم البياني. على سبيل المثال ، تم إصلاح الخلل في غضون 1-5 أيام ، ويستغرق 30-40 لكتابة مستند جديد. في الوقت نفسه ، نكتب مستندات جديدة في كثير من الأحيان أقل مما نكمله المستندات القديمة أو الأخطاء الصحيحة. لذلك ، فإن متوسط ​​وقت التنفيذ لمهمة من أي نوع (الخط الأخضر) طويل جدًا بالنسبة للأخطاء وقصير جدًا بالنسبة للمستندات الجديدة. بمساعدتها ، نحصل على فكرة متوسطة فقط عن سرعة حل المشكلات.

نظرًا لأننا ننظر في المقاييس من أجل تحسين العمليات ، فإننا نحتاج إلى النظر في شرائح أكثر دقة: على سبيل المثال ، إلى متى تم حل مشكلة "الخطأ" أو "المستند الجديد". ويمكن الاطلاع على المتوسط ​​لجميع الأنواع لتتبع الاتجاه العام.

نحن نستخدم هذه المجموعة من أنواع المهام.

هناك حالات أكثر من الأنواع ، لأن سير العمل يتطلب ذلك.

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

كيفية النظر في مقاييس الأداء

في الجزء الأخير ، قلنا أننا أجرينا دراسة وتم اختيار 20 مقياس وثائق من أصل 136. ستة منها هي مقاييس الأداء.

هناك جانبان لحساب المقاييس.

• عد المقاييس شرائح. أعلاه ، قلنا ما هو ولماذا هو مهم بالنسبة لنا.
• حساب القيم المتوسطة.

تتمثل الطريقة الكلاسيكية لحساب القيم المتوسطة في تلخيص جميع المؤشرات والقسمة على عددها. هذا النهج لا يعمل دائما بشكل جيد لأنه يأخذ في الاعتبار الحالات المتدهورة. على سبيل المثال ، نعلم أن معظم الأخطاء التي نصلحها في يوم واحد. ولكن هناك حالات متدهورة - على سبيل المثال ، يتم فقد تذكرة أو إنهاء موظف - ثم يستغرق المزيد من الوقت لإصلاحها. لنفترض أن لدينا ستة أخطاء للفترة قيد الاستعراض. قررنا خمسة في اليوم وواحد في 115. اتضح أن متوسط ​​إصلاح الخلل هو 20 يومًا. لكن هذا الرقم لا يعكس الواقع: نحن دائمًا ما نصحح الأخطاء لهذا اليوم ، وتذكرة واحدة طويلة تؤثر بشكل كبير على هذا المؤشر.

في مثل هذه الحالات ، تأتي النسبة المئوية للإنقاذ. هذه هي القيمة القصوى (في حالتنا ، المقاييس) ، والتي تناسب النسبة المئوية المحددة من الكائنات. على سبيل المثال ، تمثل النسبة المئوية 80 قيمة لا تتجاوز 80٪ من الكائنات في العينة. في حالتنا ، ستكون هذه القيمة قيمة 1 ، لأن 83٪ من الكائنات لا تتجاوزها.

هنا تظهر الطائرة الثالثة - الوقت الذي نحسب فيه المقاييس. تقريبًا جميع مقاييسنا في 30 يومًا.

نعتبر المقاييس ذات التخفيضات كما يلي:

• أولا كل الخطوط معا ،
• ثم قطعنا المنعطفات
• ثم نحن بالتفصيل: نقوم بعمل قطع في قوائم الانتظار مع قطع لجميع أنواع المهام.

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

علاوة على ذلك ، سوف نخبر كيف نعتبر مقاييس الأداء.

عدد المهام المغلقة

كما نأخذ بعين الاعتبار: وفقًا لعدد المهام التي تم إغلاقها في الفاصل الزمني [قبل 31 يومًا ؛ أمس].

عدد المهام التي اتخذت في العمل

كما نأخذ بعين الاعتبار: وفقًا لعدد المهام التي تكون بداية العمل فيها هي الفاصل الزمني [قبل 31 يومًا ؛ أمس].

عدد الأيام قبل التوظيف

كما نعتبر:

1. لكل مهمة تم نقلها للعمل في الفترة الزمنية المحددة (تاريخ البدء في Tracker في الفترة [31 يومًا ؛ بالأمس]) ، فإننا نعتبر عدد الأيام الكاملة المنقضية بين البيان (تاريخ إنشاء الحقل) وبدء المهمة (تاريخ بدء الحقل) .
2. نلخص كل القيم التي تم الحصول عليها في الخطوة الأولى.
3. نقسم المبلغ المستلم على عدد المهام التي قمنا بها من أجل العنصر الأول.

بالنسبة إلى النسب المئوية ، يتم حذف العنصر 3 ، ويتم فرز القيم بترتيب تصاعدي ، ويتم تحديد القيمة التي تتوافق مع النسبة المئوية المحددة.

عدد الأيام لإكمالها

كما نعتبر.

1. لكل مهمة تم إكمالها في الفترة الزمنية المحددة (تاريخ الانتهاء في Tracker في الفاصل [قبل 31 يومًا ؛ أمس]) ، نأخذ في الاعتبار عدد الأيام الكاملة المنقضية بين بداية العمل (تاريخ بدء الحقل) والمهمة (تاريخ انتهاء الحقل).
2. نلخص كل القيم التي تم الحصول عليها في الخطوة الأولى.
3. نقسم المبلغ المستلم على عدد المهام التي قمنا بها من أجل العنصر الأول.

بالنسبة إلى النسب المئوية ، يتم حذف العنصر 3 ، ويتم فرز القيم بترتيب تصاعدي ، ويتم تحديد القيمة التي تتوافق مع النسبة المئوية المحددة.

عدد المهام دون رد فعل أكثر من 14 يومًا

كما نعتقد: من خلال عدد المهام التي لم يحدث فيها شيء لأكثر من 14 يومًا. يتم تحديده بواسطة الحقل المحدّث في Tracker: يجب أن تكون قيمة الحقل أقل من "البارحة - 14 يومًا".

الدين الفني

كما نراها: حسب عدد المهام التي تم تعيين حالة Backlog لها في Tracker.

التنفيذ التقني لحساب مقاييس الأداء

في المستوى الأعلى ، يتكون نظام العد المتري من المكونات وروابط المعلومات التالية.

من المقرر برنامج العد المتري

نحن نستخدم السكينة ، منصة الحوسبة العالمية. وهو يصف رسميًا الترتيب الذي يتم به تشغيل العمليات. جنبا إلى جنب مع المجدول الداخلي (المجدول) يستبدل السكينة لنا مع مجموعة من البرامج النصية باش وكرون.

يعمل البرنامج المكتوب بلغة Python بانتظام ويطلب البيانات اللازمة لحساب المقاييس.

نظام تحديد المهام

يتم تخزين البيانات لحساب المقاييس في حالتنا في Yandex.Tracker. كواجهة للبيانات ، نستخدم واجهة برمجة تطبيقات Yandex.Tracker Python - وهي عبارة عن مجمّع على HTTP API ، مما يسمح بتلقي المعلومات بشكل أسرع وأسهل في هياكل البيانات المناسبة للمعالجة الإضافية.

يمكنك اختيار نظام مناسب مع واجهة برمجة تطبيقات مناسبة ، على سبيل المثال ، Jira.

نظام إعداد الرسم البياني

بعد حساب المقاييس استنادًا إلى بيانات Yandex.Tracker ، يقوم برنامجنا بإنشاء ملفات JSON ونقلها إلى خدمة Yandex.Statistics الداخلية لرسم الرسوم البيانية.

يمكنك استخدام نوع من مكتبة JS التي يمكنها بناء الرسوم البيانية. نظرة عامة على بعض الحلول المماثلة على Habré:

أفضل 15 مكتبات JavaScript

في الجزء التالي ، سنصف كيف ننظر في مقاييس جودة وثائق المستخدم.