كيف تبني صفحة سجل التغييرات: مدخلات ووسوم وRSS و«ما الجديد»

صفحة سجل التغييرات هي قائمة مؤرّخة بما تغيّر في منتجك، الأحدث أولًا، مكتوبة للأشخاص الذين يستخدمونه. لبنائها تحتاج إلى مدخلات لها تاريخ وعنوان واضح وشرح قصير ووسم (جديد، تحسين، إصلاح)، وصفحة تعرض هذه المدخلات، وعنوان URL منفصل لكل مدخل، ويُفضّل خلاصة RSS وطريقة لإخبار المستخدمين بوجود شيء جديد. إنها من أبسط الأشياء التي يمكنك بناؤها، والقرار الرئيسي هو مكان وجود المدخلات: كملفات داخل موقعك، أو في قاعدة بيانات مع صفحة إدارة.

لماذا يستحق سجل التغييرات الوجود

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

سجل التغييرات ليس سجل الـ commits الداخلي. عبارة «إعادة هيكلة خدمة الفوترة» لا تعني شيئًا للمستخدم. أما «الفواتير تعرض الآن رقم ضريبة القيمة المضافة لشركتك» فتعني له الكثير.

ما تحتاجه الصفحة

المحتوى لكل مدخل

الصفحات

• فهرس سجل التغييرات: الأحدث أولًا، مع فلاتر للوسوم وترقيم بسيط أو زر «تحميل المزيد».
• صفحة المدخل: مدخل واحد لكل عنوان URL، حتى يمكن ربطه ومشاركته.
• خلاصة RSS أو Atom: تتيح للناس وللأدوات متابعة التحديثات دون بريد إلكتروني.
• صفحة الإدارة (فقط في نسخة قاعدة البيانات): كتابة المدخلات ومعاينتها وجدولتها ونشرها.

إضافات داخل التطبيق

• شارة «ما الجديد»: نقطة بجانب عنصر في القائمة عندما تكون هناك مدخلات لم يطّلع عليها المستخدم. خزّن تاريخ آخر مدخل فتحه، لكل مستخدم أو في المتصفح.
• ملخص بريدي: ملخص يُرسل للمستخدمين الذين اشتركوا فيه. هذا يحتاج إلى مزوّد إرسال؛ انظر كيف ترسل رسائل بريد من تطبيقك.

القرار الرئيسي: ملفات أم قاعدة بيانات

مدخلات كملفات داخل الموقع

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

يناسب الفرق التي يكون فيها من يكتب المدخلات مرتاحًا لطلب ذلك من أداة بناء بالذكاء الاصطناعي أو لتحرير ملف.

مدخلات في قاعدة بيانات مع صفحة إدارة

تُخزَّن المدخلات في جدول، وتتيح صفحة إدارة خاصة لأي شخص في الفريق الكتابة والمعاينة والجدولة والنشر. يناسب هذا فرقًا يكتب فيها التسويق أو الدعم التحديثات، أو عندما تريد نشرًا مجدولًا أو مدخلات لجماهير محددة (مثلًا، إظهار ميزات المؤسسات للعملاء المؤسسيين فقط).

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

كتابة مدخلات يقرؤها الناس

• ابدأ بالفائدة. «تصدير التقارير إلى Excel» أفضل من «وحدة تصدير جديدة».
• قل من يحصل عليها. كل الخطط، أو Pro فقط، أو تُطرح هذا الأسبوع.
• أظهرها. لقطة شاشة واحدة أو مقطع قصير.
• اجمع الإصلاحات الصغيرة. مدخل أسبوعي بعنوان «إصلاحات وتحسينات» مع نقاط يمنع الصفحة من أن تغرق.
• كن صادقًا بشأن الإزالة. إذا كانت ميزة ستختفي، فقل متى وما الذي يُستخدم بدلًا منها.

طلب أول يعمل

أضف سجل تغييرات عامًا إلى موقعنا على المسار /changelog. كل مدخل ملف Markdown فيه عنوان وتاريخ ووسم (جديد، تحسين أو إصلاح)، وصورة غلاف اختيارية، ومحتوى. تعرض صفحة الفهرس المدخلات الأحدث أولًا مع التاريخ والوسم وأول فقرة، ولها أزرار فلترة للوسوم، وتعرض 10 مدخلات في كل صفحة. لكل مدخل صفحته الخاصة على /changelog/<slug> مع عنوان صفحة ووصف مناسبين لمحركات البحث. أضف خلاصة RSS على /changelog/rss.xml. أنشئ ثلاثة مدخلات تجريبية. طابق التصميم الحالي للموقع، واجعله قابلًا للقراءة على الهواتف، وأعدّ الصفحات مسبقًا حتى تُحمّل بسرعة.

في نسخة قاعدة البيانات، استبدل الجملة الأولى بـ «خزّن المدخلات في قاعدة بيانات مع حالة مسودة/منشور وتاريخ نشر، وأضف صفحة إدارة محمية بكلمة مرور لكتابتها ومعاينتها ونشرها».

خطوات البناء

1. قرر بين الملفات وقاعدة البيانات باستخدام الجدول أعلاه.
2. ابنِ صفحتي الفهرس والمدخل مع بضعة مدخلات تجريبية.
3. أضف الوسوم والفلاتر.
4. أضف خلاصة RSS واربطها من الصفحة.
5. أضف عناوين الصفحات والأوصاف وإدخال خريطة الموقع لكل مدخل. يغطي دليلنا حول تحسين محركات البحث لمواقع المبنية بالذكاء الاصطناعي الأساسيات.
6. صفحة الإدارة وتسجيل الدخول، إذا اخترت مسار قاعدة البيانات.
7. شارة «ما الجديد» في تطبيقك.
8. اكتب مدخلات حقيقية للأشهر القليلة الماضية حتى لا تُطلق الصفحة فارغة.

الأخطاء الشائعة

• نسخ رسائل الـ commits. اكتب للمستخدمين لا للمطورين.
• صفحة واحدة ضخمة بلا عناوين URL لكل مدخل. لا يستطيع أحد ربط تغيير معين، ويرى محرك البحث صفحة واحدة بدلًا من صفحات كثيرة.
• توقف التحديثات بعد شهر. سجل تغييرات آخر تحديث له قبل سنة يوحي بمنتج مهجور. حدد إيقاعًا تستطيع الاستمرار فيه.
• تحميل المدخلات في المتصفح فقط. قد يرى محركات البحث وروابط المعاينة صفحة فارغة. أعدّها مسبقًا أو اعرضها على الخادم.
• خلط الحوادث بالسجل. الأعطال تنتمي إلى صفحة حالة، لا إلى سجل التغييرات.

متى تكون أداة سجل تغييرات مستضافة هي الخيار الأفضل

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

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

البناء مع Mythex

في Mythex يمكنك أن تطلب من الوكيل إضافة سجل تغييرات إلى مشروع موجود، أو بناؤه كموقع صغير مستقل، وترى النتيجة في المعاينة المباشرة أثناء البناء. النسخة المعتمدة على الملفات لا تحتاج إلى قاعدة بيانات. وإذا اخترت نسخة الإدارة، يضيف الوكيل قاعدة بيانات Postgres مخصصة عندما تحتاج المدخلات إلى الحفظ (أو اكتب /database)، وتُخزَّن لقطات الشاشة في تخزين ملفات المشروع. تسجيل دخول الإدارة شيء تضيفه بنفسك بأسلوب المصادقة الذي تختاره (وصفة إضافة تسجيل الدخول).

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

الأسئلة