mirror of
https://github.com/odoo/documentation.git
synced 2026-01-02 17:59:20 +07:00
3a6366b18f21121a8bdcb6ebebc456637a8ab61e
This is a long term project, following the recurring question we currently face at the support func & tech
Done in the commit:
1/ Modify the references to discuss/advanced/ to match a newly created folder
specific for email communication (more generic and not specifically linked to the discuss app)
called `email_communication`.
2/ Creation of the new folder under 'Practical Information' in the documentation/user (bottom of the page)
that will handle of the mechanism around emails, including (none exhaustive list)
1/ Modify the references to discuss/advanced/ to match a newly created folder
specific for email communication (more generic and not specifically linked to the discuss app).
2/ Creation of the new folder under 'Practical Information' in the documentation/user (bottom of the page)
that will handle of the mechanism around emails, including (none exhaustive list):
email_communication/get_started.rst > A small introduction of the content of this section Email communication
email_communication/get_helped.rst > A file that is providing reason why the emails might not be properly sent
+ contact the support and what to tell them. In order to have the quickest and best answer.
email_communication/advanced/mail_servers.rst > An explanation on how to use an outgoing mail server in Odoo.
+ how to configure SPF DKIM DMARC for Odoo.
(Not modified yet, only mv from `discuss` folder)
email_communication/advanced/email_template.rst > Contain informations about email templates
(Not modified yet, only mv from `discuss` folder)
More to come, in collaboration with GOR, EDV, JQU, ALA
task-1925363
===========================
End-user Odoo documentation
===========================
Build the documentation
=======================
Requirements
------------
- `Git <https://www.odoo.com/documentation/user/contributing/documentation/introduction_guide.html#install-git>`_
- | `Python 3 <https://www.odoo.com/documentation/user/contributing/documentation/introduction_guide.html#python>`_
| If you don't know which subversion to choose, pick the last one.
| Python dependencies are listed in the file ``requirements.txt`` located in the root
directory.
- Sphinx 2.4.0 or above.
- Werkzeug 0.14.1
- `Make <https://www.odoo.com/documentation/user/contributing/documentation/introduction_guide.html#make>`_
Instructions
------------
In a terminal, navigate to the root directory and execute the following command:
.. code-block:: console
$ make html
This compiles the documentation to HTML.
Open ``documentation-user/_build/html/index.html`` in your web browser to display the render.
See `this guide
<https://www.odoo.com/documentation/user/contributing/documentation/introduction_guide.html#prepare-your-version>`_
for more detailed instructions.
Contribute to the documentation
===============================
For contributions to the content of the documentation, please refer to the `Introduction Guide
<https://www.odoo.com/documentation/user/contributing/documentation/introduction_guide.html>`_.
To **report a content issue**, **request new content** or **ask a question**, use the `repository's
issue tracker <https://github.com/odoo/documentation-user/issues>`_ as usual.
Learn More
==========
To learn more about Odoo, in addition to the documentation, have a look at `the official eLearning
<https://odoo.com/slides>`_ and `Scale-up, The Business Game
<https://www.odoo.com/page/scale-up-business-game>`_
Description
Languages
reStructuredText
93.7%
SCSS
3.2%
JavaScript
1.7%
Python
0.9%
HTML
0.3%
Other
0.1%