أظهر المشكلة.
وأرفق الشيفرة والخطأ.

بدلًا من الاكتفاء بقول «الشيفرة لا تعمل»، شارك مثالًا صغيرًا يمكن تشغيله ويُظهر المشكلة، مع النتيجة المتوقعة والنتيجة الفعلية.

تستغرق القراءة نحو دقيقتين

محادثة تتعطل

سارة

كتبت شيفرة لإرسال بريد إلكتروني، لكنها لا تعمل. أين الخطأ؟

من دون الشيفرة والأخطاء وتفاصيل بيئة التشغيل، تصبح معظم الإجابات تخمينات.

سؤال يمكن الإجابة عنه

سارة

يُفترض أن ينجح هذا الطلب، لكنه يعيد 401: fetch("/api/send", { method: "POST" }) تتطلب نقطة النهاية تسجيل الدخول. لم أحذف ملف تعريف ارتباط الجلسة. ما الذي ينبغي أن أتحقق منه في الطلب؟

هناك مثال محدد يمكن فحصه.

مثال صغير ومكتمل وقابل لإعادة الإنتاج

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

شارك الشيفرة كنص داخل كتلة شيفرة ليتمكن الآخرون من قراءتها والبحث فيها وتشغيلها. قد تضيف لقطة الشاشة سياقًا مفيدًا، لكنها لا تغني عن نص الشيفرة أو الخطأ.

استبدل كلمات المرور والرموز السرية وبيانات المستخدمين الحقيقية بقيم تجريبية قبل المشاركة. شغّل المثال مرة للتأكد من أنه لا يزال يُظهر المشكلة.