feat: mail provider

Signed-off-by: SebastianKrupinski <[email protected]>

Author: SebastianKrupinski

developer_manual/digging_deeper/groupware/mail_provider.rst

@@ -16,17 +16,17 @@ The reverse is also possible, one can register an app to supply mail services to
 Terminology
 -----------
 
-For clarificaftion this is a referace of terminology used.
+For clarificaftion this is a reference of terminology used.
 
 1. *Provider* - this is the app that provides mail services e.g. "BigHostingApp", this can a general app for a specific protocol
-2. *Service* - this is a configure mail service account e.g. "Big Email Hosting Co". Each mail provider may have multiple mail services configure for a user.
+2. *Service* - this is a configured mail service account e.g. "Big Email Hosting Co". Each mail provider may have multiple mail services configured for a user.
 
 .. _mail-provider-consume:
 
 Consuming a Mail Service
 ------------------------
 
-To use mail a service provided by another app your app only needs to instance the mail manager class, then use the built in methods to list or find an appropriate provider and service.
+To use mail as a service provided by another app, your app needs to instantiate the mail manager class, then use the built in methods to list or find an appropriate provider and service.
 
 .. code-block:: php
 
@@ -116,7 +116,7 @@ For your app to provide mail service to other apps, your app needs to implement
 Step 1: Create a Mail Provider Class
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The mail provider class is the main class that the mail manager uses to retrieve available services from your app. Each mail provider can have multiple mail services configure for a user.
+The mail provider class is the main class that the mail manager uses to retrieve available services from your app. Each mail provider can have multiple mail services configured for a user.
 
 This class needs to implement the `IProvider` interface and have all the required methods defined.
 
@@ -150,7 +150,7 @@ This class needs to implement the `IProvider` interface and have all the require
         }
 
         public function findServiceByAddress(string $userId, string $address): IService | null {
-            // app specific code to find a with a specific email address
+            // app specific code to find a service with a specific email address
         }
 
     }
@@ -196,7 +196,7 @@ This class needs to implement the `IService` interface and have all the required
         }
 
         public function getSecondaryAddresses(): array {
-            // app specific code to retrieve the secondary (aliases) email addresses of the service
+            // app specific code to retrieve the secondary email addresses (aliases) of the service
         }
 
         public function initiateMessage(): IMessage {
@@ -214,7 +214,7 @@ This class needs to implement the `IService` interface and have all the required
 Step 3: Register the Mail Provider
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The registration is performed at the initial stages of your app being loaded by the Nextcloud system, inside the 'AppInfo/Application.php'
+The registration is performed at the initial stages of your app being loaded by the Nextcloud system, inside the 'AppInfo/Application.php' file
 
 .. code-block:: php
     
@@ -234,7 +234,7 @@ The registration is performed at the initial stages of your app being loaded by
 
         public function register(IRegistrationContext $context): void {
 
-            // Tip: If your app spans multiple version of Nextcloud, we recommend testing to make sure the method exists 'method_exists()' first
+            // Tip: If your app spans multiple version of Nextcloud, we recommend to make sure the method exists with 'method_exists()'
             $context->registerMailProvider(MailProvider::class);
 
         }