Vorschlag zur Verbesserung der Dokumentation:
Bei der Konfiguration von SMTP mit einem externen Anbieter (ich habe SendGrid verwendet) habe ich keine Registrierungs-E-Mails erhalten. Die Ausführung von discourse-doctor identifizierte den Fehler: Reason: 550 The from address does not match a verified Sender Identity.
Obwohl ich die Top-Level-Domain (example.com) für den Versand in SendGrid authentifiziert hatte, hatte ich die Subdomain von Discourse (discourse.example.com) noch nicht authentifiziert, und so lehnte SendGrid die API-Aufrufe ab.
Obwohl ich nur etwa 15 Minuten gebraucht habe, um das herauszufinden, halte ich es für hilfreich, einen zusätzlichen Kommentar in app.yml und im Installationsskript hinzuzufügen, der dies für neue Benutzer, die Discourse in Zukunft installieren, klarer macht, um Reibungsverluste zu reduzieren. Auch ein direkter Verweis auf die Fehlerbehebungsseite wäre hilfreich.
Etwas wie:
# Die meisten SMTP-Anbieter verlangen eine authentifizierte Domain oder eine authentifizierte E-Mail-Adresse, um E-Mails zu versenden. Bitte stellen Sie sicher, dass Sie Ihre sendende Domain
# (example.com), Subdomain (discourse.example.com) und die E-Mail-Adresse `notifications` bei Ihrem SMTP-Anbieter authentifiziert haben, bevor Sie neue Benutzer registrieren, um die Zustellbarkeit von E-Mails sicherzustellen.
#
# Der Befehl `discourse-doctor` kann bei der Überprüfung Ihrer E-Mail-Konfiguration helfen.
# Siehe: https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install