Предложение по улучшению документации:
При настройке SMTP с использованием внешнего провайдера (я использовал SendGrid) я не получал письма с подтверждением регистрации. Запуск discourse-doctor выявил ошибку: Reason: 550 The from address does not match a verified Sender Identity.
Хотя у меня был аутентифицирован для отправки почты основной домен (example.com) в SendGrid, я еще не аутентифицировал поддомен discourse (discourse.example.com), из-за чего SendGrid отклонял вызовы API.
Хотя мне потребовалось всего около 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