[ADD] Prevacation commit to be commented

Finish the get_helped part, one screenshot missing + change on the review not yet done
Starting the get_started part, comments are welcomed

email_communication/overview.rst

@@ -5,6 +5,7 @@ Overview
 .. toctree::
    :titlesonly:
 
-   overview/get_helped
    overview/get_started
+   overview/get_helped
+   
     

email_communication/overview/get_helped.rst

@@ -13,15 +13,13 @@ You reached your daily limit
 .. warning:
     Applies to Odoo Online and Odoo.sh platforms only.
 
-Odoo caps the number of emails that can be sent every day, for security and
+Odoo caps the number of emails that can be sent every day, to keep the database and mail servers safe and to prevent the spam.
-stability reasons.
 
 Here are the default limits for new databases:
 
-- 200 emails/day for Odoo Online and Odoo.sh databases,
+- 200 emails/day for Odoo Online and Odoo.sh databases with an active subscription,
-- 50 emails/day for Odoo Online "2 weeks free trial" database.
+- 50 emails/day for one-app free and trial databases.
 
-// TODO RIM One app free?
 // TODO RIM pas clair
 
 In case you hit the limit, you can:
@@ -29,7 +27,8 @@ In case you hit the limit, you can:
 
 // TODO RIM lien vers le support form
 - either ask our support team to increase your daily limit (we will analyze your
-  situation: how many users in your database, which apps, how much traffic...)
+  situation: how many users in your database, which apps, how much traffic...).
+  You can contact the support by the following `link <https://www.odoo.com/help>`
 
 - either use your own outgoing email server: you can do (nearly) whatever you want, it's your server!
   In that case, here is our documentation about how to configure it:
@@ -70,7 +69,7 @@ Click on an email marked in red and select the tab `Failure Reason`.
 If Odoo was not able of providing you with an error message, you should ask the administrator
 of the email server to have a look at the log files of the Odoo server and the SMTP server
 (or contact the Odoo Support if you are hosted on one of our cloud platforms).
-s
+
 .. note::
    The "Technical" menu is visible in Deveoper mode only, see
    :doc:`../../../general/developer_mode/activate`
@@ -102,15 +101,102 @@ If you use a well-known email provider like Gmail or Office 365, you have to com
    :doc: `../advanced/email_servers`
 
 
-Emails went out of Odoo but you still see ared envelop
+Emails went out of Odoo but you still see a red envelop
-======================================================
+=======================================================
 
 // TODO RIM merge with section "envelop is red"
 
 It might happen that some emails are not going out properly and Odoo has no power on this.
 For diverses reason, during the transit of the email, an error occurs and a bounce email is sent back to the sender to letting him know that it didn't reach its destination.
 
-In case the email is sent using Odoo, the bounce email should reach the Odoo database and display a red envelop. To be able to investigate, please refer to the subsection `The envelop is red in the chatter`
+In case the email is sent using the Odoo, the bounce email should reach the Odoo database and display a red envelop. To be able to investigate, please refer to the subsection `The envelop is red in the chatter`
 
 For now, Odoo is not always capable of providing the information on the reason it failed.
-The technology of the mails is old and extensible, the different providers implement a personalized policy of the mails.
+The technology of the mails is old and extensible, the different providers implement a personalized policy of the mails.   
+
+Emails are going out but there is a delay
+=========================================
+
+We prioritize differently emails going out from Odoo, some needs to be direct and some might be delayed:
+When you schedule a mailing campaign using our email marketing application, the emails are depending on a scheduled action (action to trigger at a specific moment)
+
+It may happen that you schedule some Mailing campaign but it is not sent at the precise time. 
+
+This happens for example with Mailing Campaign, the emails you send directly from a Sales Order, quotation.. are sent directly. We use that policy in order to avoid cluttering the mail servers and prioritize the communication. 
+In the case of a mailing campaign using our app, you will see a banneer on the campaign mentioning when the emails will be sent.
+You can see the emails in the queue by going on the General Settings, Technical menu (in debug mode), emails. The one with the subject of your mailing campaign and being in the state ' sending '.
+You can also send them directly by going in the Scheduled action menu under: General Settings, Technical menu (in debug mode). Selecting the action 'Mass Mailing: Process Queue' and forcing it 
+
+.. image:: media/scheduled_actions.png
+   :align: center
+   :alt: Find the scheduled actions related to emails.
+
+.. Screenshot is missing!
+
+Messages vs Emails in Odoo
+==========================
+
+We use 2 types of written notifications, the messages and the emails. If they could contain the same information, they have different purposed:
+- The messages are using to be display in the chatter. The model is 'mail.message' containing a minimum of information to be displayed on the correct thread and record.
+   They can be found on the General Settings, Technical menu (in debug mode), messages
+
+.. image:: media/mail_message.png
+   :align: center
+   :alt: A mail message link to a specific record and thread.
+
+- The emails are the equivalent of the one received in the mailbox, with all the information that might not be useful in Odoo. To save space and preserve the performance, once emails are sent they are removed from the database.
+It's possible to specify that some emails are not being deleted upon sending. They can be found on the General Settings, Technical menu (in debug mode), emails
+
+.. image:: media/mail_mail.png
+   :align: center
+   :alt: A mail 'mail' that is in the status sent.
+
+.. Screnshots are ok!
+
+Entering emails issue: emails are not received
+==============================================
+
+Depending on the platform you are using: 
+ - The Odoo.sh users can find they logs on the folder ~/logs/. The log file are created everyday at 4:00 UTC time. The two last days are not zipped, where the older are zipped in order to gain space.
+   The naming of the files are decremental, which means that the file named .1 is the one from yesterday and the file .2 is the day before yesterday.
+
+ - The SaaS users won't have access to their logs. However you can still submit a ticket to know the reason why a specific email has not being received. 
+ Most of the time, we do not investigate unless it is recurring but if you notice that the issue happens all the time with the same client, do not hesitate to contact us with all the necessary information.
+
+In order to get helped efficiently, please provide as much information as possible. Here is a list of what can be helpful:
+* the EML of the file, stating for ' Electronic Mail ', this is the email with all the technical information.
+
+   Here is how to find it:
+   In Gmail:
+      1/ Click on the email you are expected to find in Odoo:
+      .. image:: media/mail_gmail_side_functional.png
+         :align: center
+         :alt: A gmail mail that is expected to be received in Odoo.
+
+      2/ On the 3 dots 'settings' of the email, click on show original > Download Original after the header.
+      .. image:: media/mail_gmail_side_technical.png
+         :align: center
+         :alt: A gmail EML expected to be received in Odoo.
+
+   In Outlook:
+      1/ Click on the email you are expected to find in Odoo:
+      .. image:: media/mail_outlook_side_functional.png
+         :align: center
+         :alt: An outlook mail that is expected to be received in Odoo.
+
+      2/ On the 3 dots 'settings' of the email, click on View > Message source.
+         You will have to copy/paste in your favourite text editor 
+      .. image:: media/mail_outlook_side_technical.png
+         :align: center
+         :alt: An outlook EML expected to be received in Odoo.
+
+.. Screnshots are ok!
+
+   The documentation of your own provider might help you on how to get your EML files.
+
+   Once you get the EML of the email, adding it in attachment of your ticket is the most efficient way for us to investigate. The support will mainly focus on redundant issues.
+
+* The exactly flow you are doing in order to normally receive those email in Odoo. Is this simply a reply from an email going out from Odoo ? Are you using an incoming email server or are your forwarding somehow those emails?
+   Can you provide us with an example of an email that has been correctly forwarded ?
+
+* Have you also tested the basic flow of your database? Is is working as expected?

email_communication/overview/get_started.rst

@@ -2,9 +2,39 @@
 Communicating with your customers 
 =================================
 
-Pourquoi on vous amène ici, ce à quoi on va répondre dans les différents menus
+.. Pourquoi on vous amène ici, ce à quoi on va répondre dans les différents menus
 
-Odoo est fournit avec une solution qui permet d'envoyer des mails de manière direct => tant que tu as ton adresse mail => odoo prend ton adress mail => ca part
+.. Odoo est fournit avec une solution qui permet d'envoyer des mails de manière direct => tant que tu as ton adresse mail => odoo prend ton adress mail => ca part
 A partir du moment ou tu utilise ton outgoing ou un nom de domaine => ce a quoi vous devez faire attention SPF / DKIM / DMARC 
 
-En fonction de si vous utiliser un nom de serveur et ou un nom de domaine, vous aurez des configuraiton differentes à faire.
+.. En fonction de si vous utiliser un nom de serveur et ou un nom de domaine, vous aurez des configuraiton differentes à faire.
+
+Communication is the process of sending and receiving messages through verbal or nonverbal means. It includes oral communications, writing and graphical representations and many others. 
+More simply, communication is designating "the creation and exchange of meaning."
+
+In any communication there is a sender and a receiver, a message, and interpretations of meaning on both ends
+
+The emailing system is the main communication in Odoo between a seller and his customer. 
+They are displayed in the chatter, usually coming from a template or a direct message
+
+The mailing is the main source of communication between your database and your users, ensuring that they receive your email and you are able to receive their reply is crucial for your company.
+
+The impossibility to communicate properly will result on the lose of trust of your customers toward you.
+
+It’s one of the first implementations that was made, due to the necessity of the tool. As first an early developed tool, it also has its own limitations. All that his coming after has been implemented in regard to what was done before. In the same way, doing changes here are quite hard to do and we need to be sure it won’t break anything.
+
+  
+
+There is plenty of existing tools online that will help you ensuring that you will be successful on this:
+
+- mxtoolbox.com > Checking SPF, DKIM & DMARC compliancy with Odoo.
+
+- https://www.mail-tester.com/ > allows you to check the spam level of your email. Send email from your database to a given address and check the score to see what can be done.
+
+.. note::
+   If you have question, please ask our support agents for more information, see: 
+   :doc: `get_helped.rst`
+
+.. To be rewritten, this is first drafts, comments are welcome :) --> Probably shouldn't go too deep here
+
+.. STOP HERE, CHECK THE INTRODUCTION OF THE FILE  https://docs.google.com/document/d/1zcMfNoSGYyXz2Zvi8Pt1BPpCafR6Ds3YQUmOI5ag2HA/edit?ts=5ec3da74&pli=1#heading=h.twl4qwlpth5o

mailing_doc_last_update.patch

@@ -0,0 +1,63 @@
+diff --git a/email_communication/overview/get_helped.rst b/email_communication/overview/get_helped.rst
+index aa274ec2..92f5d81e 100644
+--- a/email_communication/overview/get_helped.rst
++++ b/email_communication/overview/get_helped.rst
+@@ -13,15 +13,13 @@ You reached your daily limit
+ .. warning:
+     Applies to Odoo Online and Odoo.sh platforms only.
+ 
+-Odoo caps the number of emails that can be sent every day, for security and
+-stability reasons.
++Odoo caps the number of emails that can be sent every day, to keep the database and mail servers safe and to prevent the spam.
+ 
+ Here are the default limits for new databases:
+ 
+-- 200 emails/day for Odoo Online and Odoo.sh databases,
+-- 50 emails/day for Odoo Online "2 weeks free trial" database.
++- 200 emails/day for Odoo Online and Odoo.sh databases with an active subscription,
++- 50 emails/day for one-app free and trial databases.
+ 
+-// TODO RIM One app free?
+ // TODO RIM pas clair
+ 
+ In case you hit the limit, you can:
+@@ -29,7 +27,8 @@ In case you hit the limit, you can:
+ 
+ // TODO RIM lien vers le support form
+ - either ask our support team to increase your daily limit (we will analyze your
+-  situation: how many users in your database, which apps, how much traffic...)
++  situation: how many users in your database, which apps, how much traffic...).
++  You can contact the support by the following `link <https://www.odoo.com/help>`
+ 
+ - either use your own outgoing email server: you can do (nearly) whatever you want, it's your server!
+   In that case, here is our documentation about how to configure it:
+@@ -70,7 +69,7 @@ Click on an email marked in red and select the tab `Failure Reason`.
+ If Odoo was not able of providing you with an error message, you should ask the administrator
+ of the email server to have a look at the log files of the Odoo server and the SMTP server
+ (or contact the Odoo Support if you are hosted on one of our cloud platforms).
+-s
++
+ .. note::
+    The "Technical" menu is visible in Deveoper mode only, see
+    :doc:`../../../general/developer_mode/activate`
+@@ -102,7 +101,7 @@ If you use a well-known email provider like Gmail or Office 365, you have to com
+    :doc: `../advanced/email_servers`
+ 
+ 
+-Emails went out of Odoo but you still see ared envelop
++Emails went out of Odoo but you still see a red envelop
+ ======================================================
+ 
+ // TODO RIM merge with section "envelop is red"
+@@ -110,7 +109,7 @@ Emails went out of Odoo but you still see ared envelop
+ It might happen that some emails are not going out properly and Odoo has no power on this.
+ For diverses reason, during the transit of the email, an error occurs and a bounce email is sent back to the sender to letting him know that it didn't reach its destination.
+ 
+-In case the email is sent using Odoo, the bounce email should reach the Odoo database and display a red envelop. To be able to investigate, please refer to the subsection `The envelop is red in the chatter`
++In case the email is sent using the Odoo, the bounce email should reach the Odoo database and display a red envelop. To be able to investigate, please refer to the subsection `The envelop is red in the chatter`
+ 
+ For now, Odoo is not always capable of providing the information on the reason it failed.
+-The technology of the mails is old and extensible, the different providers implement a personalized policy of the mails.
+\ No newline at end of file
++The technology of the mails is old and extensible, the different providers implement a personalized policy of the mails.   
+\ No newline at end of file