c987026527
Backport of https://github.com/odoo/documentation/pull/1002 .
In V12 and V13, Gengo can't be used on SaaS and Odoo.sh by default
because they don't install the gengo Python library. If the library
is installed on Odoo.sh by the user, it still won't work, because there's
a typo in `base.gengo.translations` here (the -s is missing):
651caf0f59/addons/base_gengo/controller/main.py (L15)
This code is responsible for handling the results returned by Gengo when
the translation is ready. The typo has been present since at least 2016.
Meaning this can't have worked during that period. Fixing that typo
results in the json.loads following it failing due to an unexpected
number of arguments. That code looks it hasn't ran in a long while.
So I propose to remove mention of Gengo from the documentation in V12
and V13 to avoid any future confusion about it possibly working. Since
the feature can't have worked and support for it in V14 has already been
dropped, it doesn't seem worthwhile to attempt to bugfix it at this stage.
Odoo documentation
Build the documentation locally
Requirements
- Git
- Python 3.6, 3.7, or 3.8
- Python dependencies listed in the file
requirements.txt. - Make
- A local copy of the odoo/odoo repository in 12.0 (Optional)
Instructions
-
In a terminal, navigate to the root directory and compile the documentation to HTML with the following command:
makeAdditional commands are available with
make help. -
Open the file
documentation/_build/html/index.htmlin your web browser to display the render. -
See this guide for more detailed instructions.
Optional: to fully build the developer documentation with inline docstrings for documented Python
functions, place your local copy of the odoo/odoo repository in the root directory. Alternatively,
create a symbolic link with odoo as link name. If the Odoo sources are not found, a warning will
be shown.
Contribute to the documentation
For contributions to the content of the documentation, please refer to the Introduction Guide.
To report a content issue, request new content or ask a question, use the repository's issue tracker as usual.
If you have a pull request that is ready for review, request one from the odoo/doc-review team.