mirror of
https://github.com/odoo/documentation.git
synced 2026-01-02 17:59:20 +07:00
c3eddb6286147fa5de158c70b351c5bd88b7d53b
# If you feel that it might help a future reader to understand your commit # motivations, take some time to explain WHY you made these changes in a few # sentences. The WHAT is usually easily understood by reading the diff. # # Short description tip: structure your commit message as if it was completing # this sentence: "If merged, this commit will ...". For instance, the following # commit message is correct: "[IMP] sales: compress images to save space". # # Tag meanings: # # [ADD] = New content # [IMP] = Improvement # [FIX] = Content or RST fix # [REM] = Removal # [REF] = Refactoring (restructuring) # [MOV] = Move/rename #
===========================
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%