اقتراح تحسين المستندات:
عند تكوين SMTP مع موفر خارجي (كنت أستخدم SendGrid) لم أكن أتلقى رسائل البريد الإلكتروني للتسجيل. حدد الأمر discourse-doctor الخطأ: السبب: 550 عنوان المرسل لا يتطابق مع هوية مرسل تم التحقق منها.
بينما قمت بالمصادقة على النطاق ذي المستوى الأعلى (example.com) للإرسال في SendGrid، لم أكن قد قمت بالمصادقة على النطاق الفرعي لـ Discourse (discourse.example.com) بعد، ولذلك كان SendGrid يرفض استدعاءات واجهة برمجة التطبيقات.
بينما استغرقني هذا 15 دقيقة فقط تقريبًا لمعرفة ذلك، أشعر أنه سيكون من المفيد تضمين تعليق إضافي في app.yml وبرنامج التثبيت النصي يجعل هذا الأمر أوضح لتقليل الاحتكاك للمستخدمين الجدد الذين يقومون بتثبيت Discourse في المستقبل. أيضًا، ستكون الإشارة المباشرة إلى صفحة استكشاف الأخطاء وإصلاحها مفيدة.
شيء مثل:
# سيتطلب معظم موفري SMTP مصادقة نطاق أو عنوان بريد إلكتروني مصدق عليه
# للإرسال. يرجى التأكد من أنك قمت بالمصادقة على نطاق الإرسال الخاص بك
# (example.com) والنطاق الفرعي (discourse.example.com) وعنوان البريد الإلكتروني `notifications`
# مع موفر SMTP الخاص بك قبل تسجيل مستخدمين جدد لضمان تسليم البريد الإلكتروني.
#
# يمكن لأمر `discourse-doctor` المساعدة في اختبار تكوين البريد الإلكتروني الخاص بك.
# انظر: https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install