لماذا تكون ملاحظات الإصدار غامضة أو غير صحيحة في كثير من الأحيان؟
تفشل ملاحظات الإصدار لأنها تُكتب في اللحظة الأخيرة انطلاقًا من عناوين تذاكر العمل، ويكتبها شخص لم يشارك في كل النقاشات، لجمهور لم يحدده أحد. والنتيجة إما قائمة بمصطلحات داخلية أو ملخص متفائل يَعِد بأكثر مما أُطلق فعليًا.
تخيّل شركة برمجيات افتراضية اسمها تالي هوب، يعمل بها 15 شخصًا وتطوّر أداة حجز لاستوديوهات اللياقة البدنية. لدى مدير المنتج، ديف، قائمة التذاكر التالية التي دُمجت تغييراتها في الإصدار 4.3: 'TH-412 إصلاح خلل المنطقة الزمنية للحصص المتكررة عند الانتقال إلى التوقيت الصيفي أو منه. TH-398 ترقية تلقائية من قائمة الانتظار (علامة التفعيل waitlist_v2، إتاحة بنسبة 20%). TH-405 إعادة هيكلة خدمة المدفوعات لاستخدام SDK الجديد. TH-410 تغيير اسم الأعضاء إلى العملاء في قائمة التنقل. TH-401 إيقاف دعم تصدير CSV v1 تمهيدًا لإزالته في 1 ديسمبر. TH-415 تحسين أداء تحميل التقويم.'
تحتاج ثلاث مجموعات مختلفة إلى معرفة تفاصيل هذا الإصدار. يهتم أصحاب الاستوديوهات بقائمة الانتظار والقائمة التي تغير اسمها وإلغاء ميزة التصدير. ويحتاج فريق الدعم إلى معرفة من تتاح لهم قائمة الانتظار، وما ينبغي قوله عندما لا يجد أحدهم قسم الأعضاء. ويحتاج المطورون الذين يستخدمون ميزة التصدير إلى التاريخ المحدد والبديل.
كيف تكتب ملاحظات الإصدار خطوة بخطوة؟
اكتب ملاحظات الإصدار بدءًا بتأكيد ما أُطلق ولمن، ثم تصنيف التغييرات ضمن فئات ثابتة، ثم كتابة نسخة منفصلة لكل جمهور تبدأ بأثر التغييرات على القارئ وأي إجراء يجب عليه اتخاذه. يجيد الذكاء الاصطناعي التصنيف وإعادة الصياغة؛ وأنت توفّر الحقائق التي لا يمكنه معرفتها من عناوين التذاكر.
1. تأكّد مما أُطلق فعلياً
تحقق من حالة كل تذكرة مقارنةً بالإصدار: هل دُمجت التغييرات لكنها لا تزال خلف مفتاح تفعيل، أم أُتيحت جزئيًا، أم أصبحت متاحة للجميع؟ الإتاحة بنسبة 20% لا تعني أنها 'متاحة الآن'.
2. صنّف ضمن فئات
الجديد، والتحسينات، والإصلاحات، والتغييرات، وما أُوقف دعمه أو أُزيل، والمشكلات المعروفة. يبحث القراء سريعًا عن الفئة التي تعنيهم.
3. حدّد ما تراه كل فئة من الجمهور
نادرًا ما يحتاج العملاء إلى تفاصيل إعادة هيكلة الشيفرة الداخلية. ويحتاج فريق الدعم إلى تفاصيل طرح التحديث. أما المطوّرون فيحتاجون إلى التواريخ والإصدارات والبدائل.
4. ابدأ بالأثر
'أصبحت الحصص المتكررة تحافظ على توقيتها الصحيح عند تغيير الساعة' أفضل من 'أُصلح خلل المنطقة الزمنية'.
5. اذكر الإجراءات والتواريخ بوضوح
أي إجراء يجب على القارئ تنفيذه، وموعد تنفيذه، يُوضع أولًا وفي سطر مستقل.
6. رقّم الإصدارات بطريقة موحّدة
إذا كنت تستخدم الترقيم الدلالي للإصدارات، فإن الرقم الأول يشير إلى تغييرات غير متوافقة مع الإصدارات السابقة، والثاني إلى ميزات متوافقة معها، والثالث إلى إصلاحات متوافقة معها، ليتمكن القرّاء من تقدير المخاطر بنظرة سريعة.
كيف تبدو ملاحظات إصدار الذكاء الاصطناعي في صورتها الضعيفة وفي صورتها المحسّنة؟
تعليمة ضعيفة: 'اكتب ملاحظات الإصدار انطلاقًا من هذه التذاكر.' نتيجة معتادة: 'الإصدار 4.3 مليء بالتحسينات! تنقل قوائم الانتظار العملاء الآن تلقائيًا إلى الحجوزات لدى الجميع. أعدنا بناء نظام المدفوعات لإتمام الدفع بسرعة وأمان أكبر. أصبح قسم الأعضاء الآن قسم العملاء. يُحمَّل التقويم بسرعة أكبر.' ثلاث مشكلات: ميزة قائمة الانتظار متاحة لبعض الاستوديوهات فقط، وإعادة هيكلة شيفرة المدفوعات لم تتضمن أي وعد بالسرعة أو الأمان، كما غاب إلغاء التصدير بصيغة CSV، وهو التغيير الوحيد الذي يتطلب إجراءً.
التوجيه المحسّن: 'اكتب ملاحظات إصدار موجّهة إلى العملاء من أصحاب الاستوديوهات، استنادًا إلى التذاكر أدناه. الفئات: جديد، محسّن، تم إصلاحه، تمت إزالته. أدرج فقط التغييرات التي يمكن لصاحب الاستوديو ملاحظتها. التغيير TH-398 متاح لبعض الاستوديوهات فقط، لذا اذكر أنه يُطرح تدريجيًا. التغيير TH-405 داخلي؛ لا تدرجه. ضع إزالة ميزة التصدير بصيغة CSV أولًا، مع تاريخ الإزالة وما يجب استخدامه بدلًا منها: [البديل]. لا تصف فوائد لم تُذكر في التذكرة. استخدم كلمات واضحة ولا تذكر أرقام التذاكر.'
تبدأ النتيجة المحسّنة بعبارة 'إجراء مطلوب: سيُلغى التصدير الأصلي بصيغة CSV في 1 ديسمبر. استخدم [البديل] بدلًا منه.' ثم توضح أن الترقية التلقائية من قائمة الانتظار تُتاح تدريجيًا، وتشرح تغيير اسم «العملاء» في سطر واحد، وتصف إصلاح التوقيت الصيفي من حيث أثره في مواعيد الحصص. وتنتج تعليمة ثانية نسخة الدعم، متضمنة اسم علامة التحكم ونسبة الإتاحة، وتنتج ثالثة سجل تغييرات موجزًا للمطورين.
كيف تتحقق من دقة ملاحظات الإصدار؟
تحقق من ملاحظات الإصدار بربط كل جملة بتذكرة، واطلب من المهندس أو مسؤول المنتج تأكيد كل ما يتعلق بالإتاحة أو التواريخ أو طريقة العمل. ملاحظة الإصدار وعد للعملاء، لذا قد يتحول سطر لم يُتحقق منه إلى تذكرة دعم.
التوافر
هل كل ميزة متاحة للجميع، أم لفئة محددة، أم لم تُتح لأحد بعد؟ اجعل الصياغة مطابقة لحالة الإتاحة.
فوائد مختلقة
احذف كلمات مثل 'أسرع' أو 'أكثر أمانًا' أو 'أسهل' ما لم يستند استخدامها إلى قياس أو قرار من شخص.
الإجراءات والتواريخ
أكّد تواريخ الإزالة والبدائل مع المسؤول، وتحقق من تنسيق التاريخ الذي يستخدمه قرّاؤك.
الأسماء الظاهرة على الشاشة
يجب أن تتطابق أسماء الميزات والقوائم تمامًا مع أسمائها في المنتج، خاصة بعد تغيير أي اسم.
ما الأخطاء الشائعة في إعداد ملاحظات الإصدار بالذكاء الاصطناعي؟
الخطأ الأكثر شيوعاً هو نشر نسخة واحدة للجميع، مما يدفن الإجراء الذي يحتاج العملاء إلى اتخاذه وسط التفاصيل ويكشف تفاصيل داخلية لا يحتاجون إليها. ومن الأخطاء الأخرى: الإعلان عن ميزات خاضعة لمفاتيح تفعيل وكأنها متاحة للجميع، والسماح للأداة بإضافة ادعاءات تسويقية، وإخفاء إزالة ميزة تحت بند 'تحسينات'، وترك رموز تذاكر الدعم في ملاحظات العملاء، ولصق بنود غير معلنة من خريطة الطريق أو تفاصيل إصلاحات أمنية في أداة عامة. ويجب أن تخضع الإصلاحات الأمنية تحديداً لقواعد الإفصاح لدى فريقك قبل نشرها في أي مكان.
أين يقع هذا الدرس ضمن دليل دورات Tosheo.ai؟
ملاحظات الإصدار درس في مستوى الممارس ضمن فئة الذكاء الاصطناعي للمنتجات، إلى جانب استخلاص نتائج المقابلات، والمواصفات وقصص المستخدمين، وتحليل الملاحظات، وأبحاث المنافسين، والمفاضلات عند ترتيب الأولويات. تجد القائمة الكاملة في صفحة تدريب فرق المنتجات على الذكاء الاصطناعي. في المهمة التطبيقية، تحصل على قائمة تذاكر عمل خيالية وتكتب نسختين لجمهورين مختلفين؛ ويقيّم دليل التقييم صياغة الإتاحة، والإجراءات، والادعاءات المختلقة، ومدى ملاءمة المحتوى للجمهور.