Commit Graph

2764 Commits

Author SHA1 Message Date
Valentin Chevalier
2c676ed846 [IMP] developer/howtos: Add missing information about debug mode
In chapter 3 of the developer core training, one is asked to click on a
button that is only shown in debug mode but there is no indication about
this mode in this chapter.

closes odoo/documentation#2302

X-original-commit: 96d822bf87
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-27 09:59:58 +02:00
Donatienne Pirlot
6039ab126c [IMP] accounting: note about outstanding accounts
task-2868642

closes odoo/documentation#2295

X-original-commit: 11f9c35191
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-06-24 17:42:08 +02:00
Antoine Vandevenne (anv)
873dc25718 [IMP] redirects: split redirects.txt into multiple, per-version, files
The `redirects.txt` file used to specify redirect rules for renamed or
moved documentation pages is starting to grow too big to be easily
maintainable. The main reason is that the number of redirect rules that
were thought to be required has been largely underestimated when
implementing the 'redirects' extension. At first, we believed that no
guidelines or structure were necessary because only a small amount of
redirect rules would be specified. This proved wrong and the file is now
becoming a mess, making it increasingly difficult to figure out where,
why, when, and if a redirect rule is specified in the file.

As the file is versioned, another issue emerges: conflicts occur every
time a commit is forward-ported to a later version if that commit adds a
redirect rule at the end of the file or at a line that was changed in
the later version. As redirect rules are frequently added, and since
blocks of redirect rules for new versions are added at the end of the
file, this tends to happen a lot.

This commit attempts to hit two birds with one stone by splitting the
`redirects.txt` file into multiple files, one per version. While doing
so, the existing redirect rules are ordered alphabetically and moved
into contextual blocks. Instructions and guidelines on how to create
redirect rules are also listed in the `redirects/MANUAL.md` file. By
sorting the redirect rules and adding them in different files, the
number of conflicts should decrease by a lot.

task-2891912

closes odoo/documentation#2289

X-original-commit: f8b03c5554
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-24 10:52:03 +02:00
Antoine Vandevenne (anv)
14531d43d0 [IMP] odoo_theme: open images in a modal
task-2358082

closes odoo/documentation#2282

X-original-commit: 2a867b4f60
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Elisabeth Dickinson (edi) <edi@odoo.com>
2022-06-23 14:04:49 +02:00
Antoine Vandevenne (anv)
54bbc778bc [FIX] odoo_theme: correctly test for fallback URLs when using switchers
closes odoo/documentation#2272

X-original-commit: 9e84b6f681
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-23 10:51:56 +02:00
Donatienne Pirlot
ebbb7d2f62 [IMP] accounting: new content for invoice digitization (ocr)
closes odoo/documentation#2260

Id: 2320188
X-original-commit: c8fd4608d4
Signed-off-by: Pirlot Donatienne (dopi) <dopi@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-06-21 20:21:35 +02:00
Antoine Vandevenne (anv)
57a21f7f71 [FIX] redirects: add missing redirect rule for external_api.rst
The redirect rule was omitted in commit 3465475f.

closes odoo/documentation#2255

X-original-commit: 060e8f2344
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-21 12:10:39 +02:00
“Chiara
3e5393a558 [FW][IMP] accounting: remove the odoo tutorials invoices link
Deleting the Odoo Tutorials Invoices link since the course has been merged, and the link isn't necessary anymore.

closes odoo/documentation#2248

Forward-port-of: odoo/documentation#2243
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-20 18:33:43 +02:00
lma-odoo
2452b58ae9 Update epos_ssc.rst
Because of a recent Chrome security update, a lot of customers using peripheral devices (printers, ...) will have to follow this doc.

Therefore, I followed the doc and did the flow on my side.

I modified 'Copy to file' to 'Export' and 'Trusted Root Certification Authorities' to 'Authorities' in order to have the exact same terms as in Chrome (I guess they updated their terms at some point).

closes odoo/documentation#2235

X-original-commit: 4c4b81b12c
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-16 13:39:59 +02:00
Elisabeth Dickinson
4f2c38846d [FIX] odoo_theme: fix highlight blocks in field-list items
On pages such as /developer/reference/backend/orm.html#fields, the
highlight blocks inside `dl.field-list` items were pushing the width of
the page to go outside the screen on mobile. This is fixed by changing
the `.field-list`'s `display: grid` into `block` on mobile.

closes odoo/documentation#2228

X-original-commit: a689ea236d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-15 20:23:48 +02:00
Odoo's Mergebot
9ae0808010
[FW][MERGE] odoo_theme: revamp header and menu for better mobile support
Previously the switchers were hidden on mobile. These have been moved
to a sub-nav which also contains the button for the sidenav, leaving
more space for the searchbox so it can remain in the header. Like MDN
web docs, the navigation now slides in from the left instead of the
top.

See PR's commits for more details.

task-2800937

closes odoo/documentation#2220

Forward-port-of: odoo/documentation#2206
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-15 13:20:53 +02:00
Antoine Vandevenne (anv)
d9d2ab2434 [FIX] odoo_theme: stop testing for valid URLs if in localhost
The mechanism that makes the version and language switchers test for
valid URLs crashed when testing in localhost. The mechanism is now
skipped if the URL starts with a '/'.

X-original-commit: 98e98f65c9
2022-06-15 11:41:41 +02:00
Elisabeth Dickinson
c9f24e2794 [FIX] odoo_theme: fix searchbox's highlight-link
task-2800937

X-original-commit: 3fd32fe92a
2022-06-15 11:41:40 +02:00
Elisabeth Dickinson
e7cb811971 [IMP] odoo_theme: revamp side menu to add overlay
task-2800937

X-original-commit: 4ed8c2238a
2022-06-15 11:41:39 +02:00
Elisabeth Dickinson
0138a0822a [FIX] odoo_theme: fix menu scrolling
task-2800937

X-original-commit: 9c53901db9
2022-06-15 11:41:38 +02:00
Elisabeth Dickinson
35623039a1 [IMP] odoo_theme: add side menu collapse icon
task-2800937

X-original-commit: 7284b11a36
2022-06-15 11:41:37 +02:00
Elisabeth Dickinson
adb3cfb148 [IMP] odoo_theme: change collapsing menu orientation
task-2800937

X-original-commit: dee96ad2da
2022-06-15 11:41:36 +02:00
Elisabeth Dickinson
a1e08d7634 [IMP] odoo_theme: add subheader and adapt switchers and searchbar
task-2800937

X-original-commit: 411e1cb1d3
2022-06-15 11:41:35 +02:00
Elisabeth Dickinson
abb40e8e31 [IMP] odoo_theme: stop translating language names in the switcher
Before this commit, the language names were translated to display
"Français" instead of "French". This helped the user find their language
in the switcher but it was taking too much horizontal space, and that
space was not constant from one language to another.

This commit removes the translations of the language names and simply
goes with "FR", "NL", etc. which any user can identify as their
language.

task-2800937

X-original-commit: b1fa30f431
2022-06-15 11:41:34 +02:00
Elisabeth Dickinson
f21170d178 [IMP] design: add an icon behind external links
The external links' target attribute is now also updated to open the
link in a new tab. In addition, the "[source]" link of autodoc's models
is moved right next to the name of the model to correctly position the
icon.

task-2790244

closes odoo/documentation#2211

X-original-commit: 343decf192
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-14 14:38:01 +02:00
Elisabeth Dickinson
d88a96dada [IMP] odoo_theme: show the "On this page" section in mobile
When the page gets too small for the "On this page" section (local tree
of content) to fit on the page, the section is now moved above the menu
(global tree of content) rather than being hidden.

task-2800970

closes odoo/documentation#2199

X-original-commit: c0040fa532
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-14 12:04:04 +02:00
LoredanaLrpz
f3f14deb8c [REM] pos: remove cash control doc page in 15 bc deprecated
Task ID: 2680699

closes odoo/documentation#2190

X-original-commit: c0036ae13c
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-13 09:28:14 +02:00
Julien Castiaux
97b7bdfd5e [IMP] rdtraining: tip about -i/-u for odoo-bin
It is never shown to the trainee that he can install/update a module
right from the CLI. Multiple developpers still use the app manager to
install/update their modules multiple months into the job.

closes odoo/documentation#2185

X-original-commit: 3d2f067e6c
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
Signed-off-by: Julien Castiaux <juc@odoo.com>
2022-06-10 21:51:02 +02:00
Antoine Vandevenne (anv)
9d36e4e2a4 [FIX] requirements: pin docutils to 0.16.0
Since sphinx-tabs 3.2.0 has the requirement docutils==0.16.0 and sphinx
3.5.4 has the requirement docutils>=0.12,<0.17, this commit pins
docutils to version 0.16.0.

While we're at it, the dependency to sphinx-tabs is also explicitly
listed, although it was already imported in the extensions. It causes
no trouble to install it from pip alongside the imported extension.

closes odoo/documentation#2176

X-original-commit: 9923bb33c9
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-10 10:26:06 +02:00
Denis Vermylen
48c8d22a54 [FIX] odoo.sh: remove hidden folder from documentation
it will also be renamed to .repositories in the near future

closes odoo/documentation#2164

X-original-commit: 1afee9e2c7
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-08 09:33:16 +02:00
Jason Aerts (jaae)
226d49c239 [IMP] maintain: process for odoo.sh to odoo online
task-id 2870122

closes odoo/documentation#2157

X-original-commit: 6dc4288e49
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-03 14:19:22 +02:00
Jonathan Castillo (jcs)
de04e27d1a [ADD] accounting/l10n: new egyptian localization and einvoicing section
task-id 2858349

closes odoo/documentation#2147

X-original-commit: a2cf3da864
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-02 16:50:23 +02:00
Antoine Vandevenne (anv)
87a919e864 [FIX] homepage: fix the link to the external API page
The page was moved from odoo.rst to external_api.rst with commit
0fc52188.

task-2870501

closes odoo/documentation#2142

X-original-commit: f6cd947d6b
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-02 13:42:55 +02:00
Tom Aarab (toaa)
4197755373 [IMP] accounting: add note about bank sync not available for trial db
Added a note to specify that bank synchronization is not available on trial databases

closes odoo/documentation#2137

X-original-commit: e4fc5f07ee
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2022-06-02 13:42:48 +02:00
Jonathan Castillo (jcs)
745a1da595 [IMP] maintain: add note in hosting changes (on-premise to online)
task-id 2869953

closes odoo/documentation#2128

X-original-commit: 4cd0500408
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-06-01 19:38:29 +02:00
Antoine Vandevenne (anv)
1601ce58d0 [IMP] payment_acquirers: explain the different additional features
task-2862636

closes odoo/documentation#2120

X-original-commit: c820aa4951
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-01 10:48:54 +02:00
william
44d82e1f07 [FIX] conf: dynamic LaTeX releasename
closes odoo/documentation#2115

X-original-commit: 6d4f4f7d9b
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-05-30 17:58:02 +02:00
Demesmaeker
920bb3d816 [IMP] amazon: migrate to SPAPI
Starting July 2022, Amazon WMS API is deprecated and we need to use the Selling Partners API.

This brings changes in the authentication flow that are explained.

task-2466636

closes odoo/documentation#2106

X-original-commit: 2dd3a4ae74
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-30 16:57:57 +02:00
Michelle Vu (mivu)
d103229364 [IMP] payment: update SIX screenshots
closes odoo/documentation#2100

X-original-commit: 6dc30adf15
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-27 13:16:28 +02:00
Michelle Vu (mivu)
42b1af5d5c [IMP] helpdesk: update flow and images for reinvoicing time
closes odoo/documentation#2096

X-original-commit: 00ec789d96
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-27 13:16:23 +02:00
Michelle Vu (mivu)
e31183f4ed [FW][IMP] calendar: update Google Calendar sync screenshots
Task ID: 2685658

closes odoo/documentation#2089

Forward-port-of: odoo/documentation#1982
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-25 12:40:43 +02:00
Donatienne Pirlot
5b85b5a8e9 [IMP] accounting: update the follow-up information
Task ID: 2735445

closes odoo/documentation#2080

X-original-commit: ffc23483ca
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Pirlot Donatienne (dopi) <dopi@odoo.com>
2022-05-24 16:51:50 +02:00
Michelle Vu (mivu)
3ba2967847 [ADD] discuss: configure Twilio ICE servers
closes odoo/documentation#2073

X-original-commit: 47d1146c10
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-23 10:56:29 +02:00
Antoine Vandevenne (anv)
75e7f29fe1 [MOV] developer/api/odoo: rename odoo.rst into external_api.rst
The previous file name was not very relevant in regard to the content of
the page, and it conflicted with the `sys.path`.

closes odoo/documentation#2067

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-20 14:44:52 +02:00
Antoine Vandevenne (anv)
4649c3f8d1 [MOV] content/*: move resource files into their related page's directory
Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2067
2022-05-20 14:44:52 +02:00
Donatienne Pirlot
51d3b5f0a2 [IMP] accounting : update the list of fiscal localization packages
task id: 2858536

closes odoo/documentation#2050

X-original-commit: 6ca1fd83ec
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Pirlot Donatienne (dopi) <dopi@odoo.com>
2022-05-20 14:44:49 +02:00
Martin Trigaux
2b29e4a29b [FIX] odoo_theme: correctly consider baseurl
urlBase was only containing the domain name, not the /documentation/

closes odoo/documentation#2061

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-20 11:40:29 +02:00
Martin Trigaux
c9d95858b4 [IMP] odoo_theme: introduce fallback URLs for the page switchers
When a user clicks on the link of an alternate page in the version or
language switcher, we now check if the page referenced by the target URL
exists or not. If not, we generate a series of fallback URLs from the
target URL and check whether the targeted resource exists or not, until
we read the root of the documentation. As soon as we find a valid URL,
we redirect the user to it.

This is inspired by the behaviour of docs.python.org's version and
language switchers.

task-2534669

closes odoo/documentation#2051

X-original-commit: 25e863a64c
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 23:12:51 +02:00
Beshoy Nabeih
a572e055a8 [FIX] developer/frontend: typo in the user menu registry example
closes odoo/documentation#2038

X-original-commit: 6d30d81a76
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 15:18:59 +02:00
Altela Eleviansyah Pramardhika
d67a2492ce [FW][FIX] developer/howtos: Fixed typo from field to fields
closes odoo/documentation#2035

Forward-port-of: odoo/documentation#2023
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 15:18:56 +02:00
Tori (vpk)
cfeb1e4838 [IMP] CRM: updated lead scoring with note about deprecation
Task ID: 2496900

closes odoo/documentation#2029

X-original-commit: fca684e802
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 15:18:53 +02:00
John Kirkwood (kij)
ad21e95e8b [IMP] developer: clarify options for many2one widget
Only `no_create` is required to hide both the 'Create "xxx"' and the
'Create and Edit...' dropdown menu options.

closes odoo/documentation#2015

X-original-commit: 599a137ffc
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 14:14:58 +02:00
Tori (vpk)
b1e6b4c3e3 [IMP] CRM: updating flow and screenshots of generating leads
closes odoo/documentation#2021

Task: 2540813
X-original-commit: 44129be225
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 11:47:02 +02:00
Donatienne Pirlot
7cbc4b5673 [ADD] accounting: new doc about outstanding account
Task-id 2744131

closes odoo/documentation#2011

X-original-commit: 5de81c9e2d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-18 13:28:16 +02:00
Antoine Vandevenne (anv)
1f550b7ab0 [FIX] requirements.txt: pin Jinja2 < 3.1
The latest versions of Jinja2 are no longer compatible with the latest
version of Sphinx 3 (3.5.4).

task-2828982

closes odoo/documentation#2000

X-original-commit: 4c7e89d872
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-13 15:58:10 +02:00