Commit Graph

263 Commits

Author SHA1 Message Date
Wesley Kao (weka)
2d7b589da6 [IMP] inventory and mrp: capitalized "MRP" in toctree
In the toctree, "MRP" wasn't capitalized in "Inventory & MRP."
Affects all branches, can be forward ported.

closes odoo/documentation#2561

X-original-commit: 8c665643ce
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-08-09 10:11:38 +02:00
Donatienne Pirlot
73204e6789 [ADD] accounting: creation of electronic invoicing documentation
closes odoo/documentation#2231

Id: 2857860
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-08-08 10:54:03 +02:00
Antoine Vandevenne (anv)
4558be3a5e [IMP] install: guide the user through the login page
Developers sometimes have a hard time making the difference between the
PostgreSQL user and the internal user. They would try to log into Odoo's
web client with their PostgreSQL credentials rather than with admin. See
https://reddit.com/r/Odoo/comments/w8zubf/logging_in_on_source_install.

closes odoo/documentation#2542

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-08-01 15:10:43 +02:00
Antoine Vandevenne (anv)
9279fb80a7 [IMP] rdtraining: mention that the second part needs to be completed too
closes odoo/documentation#2536

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-08-01 12:38:54 +02:00
Victor Feyens
1c4abe4e07 [CLN] rdtraining: remove reference to unexisting file
The referenced `bypass.py` file isn't specified anywhere in
the training documentation or code content.

The paragraph is removed to avoid meaningless searches and
confusing trainees.

This commit also adds a missing parenthese in the preceding
code content.

Fixes #2488

closes odoo/documentation#2518

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-25 12:08:07 +02:00
Benoit Socias
b8ee134a28 [IMP] rdtraining: update float utils information
The warning about float utils does not state where to find them, and
they are preceded by an example in the code that infringes the warning's
recommendation.

This commit indicates where to find the float utils and replaces the
example by one that uses them.

task-2925402

closes odoo/documentation#2507

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-20 10:17:22 +02:00
Benoit Socias
77f4b4b307 [IMP] install: troubleshoot typical problems for Mac users
As mentioned in [1], because of [2], some python implementation for Mac
fail on startup with default parameters.

Also, when installing requirements, the psycopg requirement can fail
because the $PATH does not contain the postgresql tools installed with
the .app.

This commit provides instructions to avoid those issues.

[1]: https://github.com/odoo/odoo/issues/79112
[2]: https://bugs.python.org/issue40518

task-2922249

closes odoo/documentation#2495

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-19 10:04:28 +02:00
Stanislas Sobieski
4c5951953d [IMP] install/maintain: update info about upgrade process on Odoo.sh
closes odoo/documentation#2489

Id: 2744270
X-original-commit: 815acb64c4
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Pirlot Donatienne (dopi) <dopi@odoo.com>
Co-authored-by: Stanislas <sts@odoo.com>
Co-authored-by: Donatienne <dopi@odoo.com>
2022-07-18 12:33:29 +02:00
Romain Derie
e13d2517b2 [FIX] website: warn about google api deprecation
Google deprecated both its "Universal Analytics" and "Google Sign-In"
API. See community counterpart commit for a detailed explanation and
links.

closes odoo/documentation#2441

X-original-commit: 2222142127
Related: odoo/odoo#95847
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Romain Derie (rde) <rde@odoo.com>
2022-07-15 14:26:49 +02:00
Sam Lieber (sali)
a408ea5543 [ADD] maintain: google oauth doc
Added document and media files on the setup of Google Gmail using OAuth with Odoo.

closes odoo/documentation#2469

X-original-commit: 9b75dfd2ac
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-14 10:43:57 +02:00
Michelle Vu (mivu)
521cee8aa0 [IMP] helpdesk: clarify postpaid support and delete mentions of tasks
If committed, this will delete mentions of project tasks in the "Invoice
Time Spent on Tickets (Postpaid Support Services)" v14.0 user doc. It
also deletes unnecessary steps and screenshots about creating and
configuring a new Project and updates the steps and screenshots for the
"Create a sales order" and "Link the Helpdesk ticket to the SO" sections.

Fixes PR #1901
Closes Odoo Task 2870104

closes odoo/documentation#2204

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-13 17:35:43 +02:00
Antoine Vandevenne (anv)
81bf067ba1 [REF] legal: convert the table from a grid to a list table
Prior to this commit, the /legal.html page relied on RST substitutions
to insert the images directives of legal agreements within the table.
This caused Sphinx to omit the `image-reference` class on all `<a>`
elements surrounding an `<img>` element, which it normally adds when the
`target` option is specified on an `image` directive. As the theme
relies on that class to hide the "external link" icon added with commit
343decf1, the layout of the page was broken.

While replacing the substitutions with the plain `image` directive, the
grid table is converted to a list table to avoid the hassle of expanding
table cells to fit the directives. This will also help in maintaining
the content of the table when we will add new translations for the legal
agreements.

task-2909167

closes odoo/documentation#2461

X-original-commit: 2bf2604
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-13 14:27:32 +02:00
Antoine Vandevenne (anv)
f648960c78 [FIX] odoo_theme: show a cursor when hovering on an image without modal
The images that have the class `o-no-modal` cannot be clicked to open in
a modal, so the cursor should not be changed to a pointer when hovering
on them.

This commit also simplifies the theme's SCSS by replacing the hard-coded
SVG images used in the "Supported versions" page by unicode circles with
a custom styling.

X-original-commit: 556cd6b
Part-of: odoo/documentation#2461
Co-authored-by: Elisabeth Dickinson (edi) <edi@odoo.com>
2022-07-13 14:27:32 +02:00
Antoine Vandevenne (anv)
7cbbb77746 [FIX] odoo_theme: only open images that have no target in modal
Since clicking on the image redirects the user to the target URL, it's
useless to open the image in a modal. Also, it partially broke the
layout of the /legal.html page due to the modal div being inserted into
table cells.

This commit also introduces the possibility to add the `o-no-modal`
class on images that should not open in a modal.

task-2909167

X-original-commit: 54d676c
Part-of: odoo/documentation#2461
2022-07-13 14:27:32 +02:00
Antoine Vandevenne (anv)
11460f4c93 [IMP] developer/rdtraining: simplify the development environment setup
In an attempt to help new developers install Odoo with a
straightforward procedure, Chapter 2 of the "Getting started" tutorial
included copy-pastes of parts of the "Installing Odoo" page. This proved
to be inefficient because it required maintaining documentation on the
installation procedure in several places and misled the readers by
suggesting installing the Python requirements *after* installing
PostgreSQL.

With this commit, the page on Chapter 2 is refreshed to be clearer to
the readers and redirect them to the "Installing Odoo" page when
necessary.

task-2908434

closes odoo/documentation#2380

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-12 12:34:54 +02:00
“Lau-Odoo”
1b4c24277d [IMP] ecommerce: remove one sub-menu to add it as a see also
task - 2904108 I removed the "website/publish" section from the toctree to add a link to the full website documentation inside off the see also.

closes odoo/documentation#2414

X-original-commit: 7307dac6a6
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-07 18:51:52 +02:00
LoredanaLrpz
ceec1b0436 [IMP] pos: add a warning about Six unusability in July
Task ID:2893426
Since Six payment terminal won't be usable starting in July 2022, I
added this warning.

closes odoo/documentation#2413

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-07-07 18:00:19 +02:00
Demesmaeker
7f458e8a09 [FIX] sale_amazon: fix information displayed
Both carrier name and tracking reference are now displayed to the
customer, even when using the carrie `Self Delivery`

task-2900803

closes odoo/documentation#2406

X-original-commit: 471d0c2094
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-07 14:23:08 +02:00
Antoine Vandevenne (anv)
4e67b8986c [MOV] developer/misc: move all pages to a more logical location
Before this commit, the "Developer/Misc" directory of the doc, and
more particularly the "Developer/Misc/Other" sub-directory, was used as
a garbage dump where we moved all the pages that didn't fit elsewhere.
Due to that, interesting and important pages, such as the Coding
Guidelines, were buried in that directory never to be read again by Odoo
developers.

This commit moves most pages under "Misc" one or two levels up to be
located directly under "Developer" hence making them more accessible. A
new "Contributing/Development" directory is added to host the Coding
Guidelines page and soon many other pages.

task-2897143

closes odoo/documentation#2350

X-original-commit: ad374af15d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-04 10:38:45 +02:00
“Lau-Odoo”
eeb6ed53ae [IMP] website: broken link removal
task - 2841794

closes odoo/documentation#2357

X-original-commit: c40059e0a7
Signed-off-by: Auvens Ludvig (lau) <lau@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-07-01 12:54:16 +02:00
Antoine Vandevenne (anv)
7f95e9e2e0 [IMP] developer/views: apply the new API references style
The documentation of view attributes was lacking visual structure to
help the reader figure out which attribute relates to which parent
element. Since this documentation was relying on RST block quotes to
represent the hierarchy of view attributes, we can apply the same new
styling that was added with commit 934f45cf and designed for autodoc,
and which relies on the exact same HTML structure as block quotes.

task-2755298

closes odoo/documentation#2329

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-28 14:16:15 +02:00
LoredanaLrpz
85b5374995 [ADD] pos: adyen payment terminal
Task ID: 2808584
Do not Forward port r+

closes odoo/documentation#2298

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-28 11:17:16 +02:00
LoredanaLrpz
5618e5ad9b [IMP] pos: change titles
Part-of: odoo/documentation#2298
2022-06-28 11:17:16 +02:00
Jonathan Castillo (jcs)
203a74811f [IMP] contributing: update the rst cheat sheet
task - 2810468

closes odoo/documentation#2314

X-original-commit: 9ff312298d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Elisabeth Dickinson (edi) <edi@odoo.com>
2022-06-27 14:35:12 +02:00
Valentin Chevalier
733c534cc5 [ADD] payment_acquirers/adyen: add doc configuration of Adyen
Following a technical task regarding the migration of the Adyen hosted
payment page integration to Adyen PayByLink, some new parameters have
been introduced and some have been removed.

This new addition to the documentation will help users configure their
acquirer.

task-2802921

closes odoo/documentation#2306

X-original-commit: 0db39e3564
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-27 10:04:42 +02:00
Valentin Chevalier
96d822bf87 [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#2286

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-24 17:47:24 +02:00
Tom Aarab (toaa)
270a2db34b [IMP] accounting: added specification about payment flow for payment acquirer
V13 and V14 do not allow customers with no account on Odoo.com portal to pay through payment acquirers with payment flow "Payment from Odoo"

task - 2711962

closes odoo/documentation#2290

X-original-commit: 103c17f235
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-06-24 09:53:38 +02:00
Antoine Vandevenne (anv)
9dcc8bb071 [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#2267

X-original-commit: 80c7b27827
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-23 10:43:43 +02:00
“Chiara
8fe7d42514 [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#2244

Forward-port-of: odoo/documentation#2243
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-20 18:43:52 +02:00
lma-odoo
4c4b81b12c 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#2180

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-16 11:39:43 +02:00
Julien Castiaux
3d2f067e6c [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#2181

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-10 16:56:54 +02:00
Denis Vermylen
ceff736539 [FIX] odoo.sh: remove hidden folder from documentation
it will also be renamed to .repositories in the near future

closes odoo/documentation#2160

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

closes odoo/documentation#2152

X-original-commit: 6dc4288e49
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-06-03 13:39:22 +02:00
Tom Aarab (toaa)
c3a382bb88 [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#2132

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 14:16:54 +02:00
Jonathan Castillo (jcs)
8f80b265f5 [IMP] maintain: add note in hosting changes (on-premise to online)
task-id 2869953

closes odoo/documentation#2124

X-original-commit: 4cd0500408
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-06-01 19:25:57 +02:00
Demesmaeker
2dd3a4ae74 [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#2102

X-original-commit: 80408ca
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-30 13:05:46 +02:00
Michelle Vu (mivu)
00ec789d96 [IMP] helpdesk: update flow and images for reinvoicing time
closes odoo/documentation#1901

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-27 10:10:52 +02:00
Michelle Vu (mivu)
f6b22996b7 [IMP] payment: update SIX screenshots
If merged, this will update the screenshot for the "Connect a SIX Payment Terminal to your PoS" v14 user doc. In Odoo v14.0, the "Use a Payment Terminal" field only has "Six" as an option, not "Six without IoT Box." The new screenshot reflects this change and I also rewrote the step to reflect this change.

I also added alt text to the images, fixed the image file names, and fixed the image file folder name.

Related issue: https://github.com/odoo/documentation/issues/954

closes odoo/documentation#2008

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-25 10:57:00 +02:00
Michelle Vu (mivu)
b6aee793a7 [IMP] calendar: update Google Calendar sync screenshots
Task ID: 2685658

closes odoo/documentation#1982

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-25 10:56:58 +02:00
Donatienne Pirlot
b33d6529af [IMP] accounting: update the follow-up information
Task ID: 2735445

closes odoo/documentation#2076

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:02:42 +02:00
Donatienne Pirlot
d73c052ee2 [IMP] accounting : update the list of fiscal localization packages
task id: 2858536

closes odoo/documentation#2043

X-original-commit: 8acc4060c7
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-05-20 15:00:15 +02:00
Antoine Vandevenne (anv)
0fc521886f [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#2026

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-20 14:03:48 +02:00
Antoine Vandevenne (anv)
91c20a2c03 [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#2026
2022-05-20 14:03:47 +02:00
Altela Eleviansyah Pramardhika
b883c3c99c [FW][FIX] developer/howtos: Fixed typo from field to fields
closes odoo/documentation#2028

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

closes odoo/documentation#925

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-19 11:53:19 +02:00
Tori (vpk)
44129be225 [IMP] CRM: updating flow and screenshots of generating leads
closes odoo/documentation#986

Task: 2540813
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-18 18:13:36 +02:00
Jason Aerts (jaae)
6f89b9f223 [FIX] maintain: typo in domain names doc
closes odoo/documentation#1996

X-original-commit: f92889baa3
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-05-16 14:48:45 +02:00
Fabrice Henrion
de9342b70a [IMP] payment acquirers: a note in Authorize.net
closes odoo/documentation#1985

X-original-commit: df10f17c3e
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-05-12 18:35:00 +02:00
Laurent Desausoi (lade)
f6bf1183db [IMP] sale_management: remove price_unit from quotation template
Companion of [1].

[1]: https://github.com/odoo/odoo/pull/47186

opw-2824263

closes odoo/documentation#1918

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-10 14:39:42 +02:00
Demesmaeker
df486c780c [IMP] amazon: explain how to use a carrier
In case of an unsupported carrier or a self Delivery, Odoo won't block
the user to use the Amazon connector, but explanation were needed for
these cases.

task-2804907

closes odoo/documentation#1958

X-original-commit: 3231d20d92
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-09 17:59:57 +02:00