Updated email SMTP option docs

Specifically to improve those around encryption, to better explain how
the MAIL_ENCRYPTION option is used.
Relates to the work done in referece to bookstackapp/bookstack#4342

diff --git a/content/docs/admin/email-webhooks.md b/content/docs/admin/email-webhooks.md
index 04f43d4697ccb6395d3ede315d8fcf8071002eef..561c054c144e79e811c1ecba3610adc505614619 100644 (file)
--- a/content/docs/admin/email-webhooks.md
+++ b/content/docs/admin/email-webhooks.md
@@ -25,10 +25,19 @@ To get up and running with SMTP you will need to add, or set, the following vari
 ```bash
 MAIL_DRIVER=smtp
 
 ```bash
 MAIL_DRIVER=smtp
 

-# Host, Port & Encryption mechanism to use
-# Valid encryption values are: tls, ssl, null
+# SMTP server host address

 MAIL_HOST=smtp.provider.tld
 MAIL_HOST=smtp.provider.tld

+
+# SMTP server port
+# Using port 465 will force connections to be via TLS

 MAIL_PORT=587
 MAIL_PORT=587

+
+# Connection encryption to use
+# Valid values are: tls, null
+# Using 'tls' forces TLS to be used.
+# Using 'null' will not force TLS but STARTTLS will still 
+# be attempted if announced as supported by your SMTP server.
+# Using port 465 above will also force connections to be via TLS.

 MAIL_ENCRYPTION=tls
 
 # Authentication details for your SMTP service
 MAIL_ENCRYPTION=tls
 
 # Authentication details for your SMTP service


@@ -42,11 +51,12 @@ [email protected]
 MAIL_FROM_NAME=BookStack
 ```
 
 MAIL_FROM_NAME=BookStack
 ```
 

-##### SSL Certificate Verification
+##### Connection TLS/SSL Certificate Verification

 
 

-In some cases your SMTP server may be using a private/self-signed certificate that would usually fail SSL/TSL verification.
+In some cases your SMTP server may be using a private/self-signed TLS/SSL certificate that would usually fail certificate verification.

 In these cases its common for that certificate (Or its CA) to be added to the BookStack's host trusted certificate database.
 In these cases its common for that certificate (Or its CA) to be added to the BookStack's host trusted certificate database.

-If that's not possible, you can alternatively disable SSL/TLS certificate verification by adding this setting to your `.env` file:
+If that's not possible, you can alternatively disable SSL/TLS certificate verification for mail sending
+ by adding this setting to your `.env` file:

 
 ```bash
 # Verify SSL/TLS certificates during SMTP sending
 
 ```bash
 # Verify SSL/TLS certificates during SMTP sending