Jwumaكيفية كتابة معيار توضيحي يصمد أمام الواقع
· 2 دقيقة قراءة · specification, quality
أُنتجت هذه الترجمة آلياً ولم يراجعها متحدث أصلي. عند الالتباس، النسخة الإنجليزية هي الأصل. أخبرنا إذا كان هناك خطأ وسنصححه. English
يقضي المعيار الجيد معظم طوله على الحالات الحدية بدلاً من التعريفات، لأن المعلقين نادرًا ما يختلفون حول الحالات الواضحة. جمده عند بدء الدفعة حتى لا ينحرف المعيار أثناء المشروع، واعتبر كل غموض يشير إليه المعلق عيبًا في المعيار وليس فشلًا من المعلق.
باختصار
- يتركز اختلاف المعلقين تقريبًا بالكامل في الحالات الحدية.
- يجب تجميد المعيار عند بدء الدفعة وتحديد نسخته بعد ذلك.
- يجب أن يكون كل تصنيف قابلًا للتتبع إلى نسخة المعيار التي أنتجته.
- الغموض المشار إليه هو عيب في المعيار، وليس فشلًا من المعلق.
- تغيير المعيار في منتصف الدفعة يبطل المقارنة عبر تلك الدفعة.
لماذا تفشل المعايير؟
تقريبًا لا تفشل بسبب أن التعريفات خاطئة. تفشل لأن التعريفات جيدة والحالات الحدية غائبة، لذا يخترع عشرون معلقًا بشكل مستقل عشرين إجابة مختلفة لنفس السؤال غير المعالج.
العلامة الأكثر شيوعًا هي درجات الاتفاق التي تبدو مقبولة بشكل عام بينما تكون شريحة معينة من البيانات عديمة القيمة بهدوء. يخفي الاتفاق المجمع هذا جيدًا.
كم يجب أن يكون من المعيار حالات حدية؟
معظمها. إذا كان معيارك يتكون في الغالب من تعريفات مع قسم قصير من الأمثلة في النهاية، فهو قاموس وليس معيارًا.
الطريقة المثمرة لكتابة واحد هي تشغيل دفعة تجريبية صغيرة بمعيار غير محدد، وجمع كل حالة يشير إليها المعلق كغموض، وتحويل كل منها إلى قاعدة صريحة. الغرض من التجربة هو العثور على الأسئلة، وليس إنتاج البيانات.
لماذا تجميد المعيار؟
لأنه إذا تحرك المعيار في منتصف الدفعة، يصبح العمل المكتمل بشكل صحيح تحت التعريف القديم خاطئًا بأثر رجعي، ولا يمكنك معرفة من مجموعة البيانات أي العناصر تم الحكم عليها تحت أي نسخة.
التجميد يعني أن النسخة السارية عند فتح الدفعة تحكم تلك الدفعة. التحسينات تطبق على الدفعة التالية. كل تصنيف يحمل بعد ذلك النسخة التي أنتجته، وهو ما يجعل مجموعة البيانات قابلة للتدقيق بعد عام عندما يسأل شخص ما لماذا تم تصنيف عنصرين متشابهين بشكل مختلف.
كيف يجب التعامل مع الغموض المشار إليه؟
كبلاغ عن عيب في المعيار، وهو ما هو عليه. المعلق الذي يشير بدلاً من التخمين قد قام بالشيء الصحيح تمامًا ولا ينبغي معاقبته على ذلك.
المنصات التي تعاقب على الإشارة تحصل على إشارات أقل وبيانات أسوأ، لأن الغموض لا يختفي، بل يتم حله بصمت وبشكل غير متسق حيث لا يمكن لأحد رؤيته.
أسئلة أخرى
ما الذي يجعل المعيار التوضيحي جيدًا؟
التعامل الصريح مع الحالات الحدية. نادرًا ما يختلف المعلقون حول الأمثلة الواضحة، لذا فإن المعيار الذي يتكون في الغالب من تعريفات وقليل من الحالات الحدية سينتج تصنيفات غير متسقة.
هل يجب تغيير المعيار في منتصف المشروع؟
لا. جمده عند بدء الدفعة حتى لا ينحرف المعيار، وطبق التحسينات على الدفعة التالية. وإلا فإن العمل المكتمل بشكل صحيح يصبح خاطئًا بأثر رجعي.
ماذا يجب أن يحدث عندما يشير المعلق إلى حالة غامضة؟
يجب اعتباره عيبًا في المعيار وحله بشكل صريح. معاقبة الإشارة تدفع الغموض ببساطة تحت السطح حيث يتم حله بشكل غير متسق.