1) PDF files are generated and stored at the root of the CURRENT_BRANCH
directory. The links to those files are generated at different levels of
the doctree, which makes it impossible to use a relative path.
For example the same "Enterprise Agreement" doc in EN is published on:
- /16.0/legal/terms/enterprise.html
- /16.0/fr/legal/terms/enterprise.html
As a workaround, use absolute links for the PDFs. They won't work
locally for now. Can be improved later, as long as we don't break
those links located in various depths of the troctree.
2) The legal constracts aren't translated in all availables languages
(yet), so those links are 404s now. Introduced a conf.py variable
`legal_translations` with the list of languages where translated
contracts are indeed available, and falling back to the EN version
otherwise. Some languages don't have *all* the contracts translated, so
some 404 may remain temporarily.
Forward-port of f69dba70be
Adding a page on customer interaction and adding redirects. Forward to
master.
closesodoo/documentation#3860
Taskid: 3224716
X-original-commit: c24f6eca7a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Updating the Intrastat documentation to provide information related to the Intrastat report.
closesodoo/documentation#3814
Id: 3167429
X-original-commit: 5d801fbdeb
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Adding a page on customer accounts for the eCommerce doc. Forward to
master.
closesodoo/documentation#3785
Taskid: 3223001
X-original-commit: 49b45c9aa6
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
We no longer load assets by xml files, but we use __manifest__.py for that.
closesodoo/documentation#3777
Forward-port-of: odoo/documentation#3720
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit removes unnecessary `proxy_set_headers` in the serve
static config block.
Indeed, the request will either be served by Nginx in which case
the request won't go to the proxy backend or by the `@odoo` backend
which have its own `proxy_set_headers` set as the user is supposed
to copy/paste the contennt of the `location /` block.
closes odoo/documentation#3767
Closes: #3675
X-original-commit: 6129288439
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Stockbauer Matthieu (tsm) <tsm@odoo.com>
Adding a page on handling orders for the eCommerce doc, and removing
older pages. Forward to master.
closesodoo/documentation#3765
Taskid: 3214065
X-original-commit: f6fa482087
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Adding ewallets/giftcards section to the eCommerce doc. Forward to
master.
closesodoo/documentation#3756
Taskid: 3215674
X-original-commit: 70267f4535
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Id: 3099154
X-original-commit: 3bb3acbb42
Debug mode should be activated in V15 and V16 to modify the paper format
closesodoo/documentation#3730
X-original-commit: 64aaa6f784
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Pirlot Donatienne (dopi) <dopi@odoo.com>
This commit adds custom anchors, links and new see also sections
task-3212218
closesodoo/documentation#3718
X-original-commit: b7db89e77b
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
For instance, "Fix a typo"
or "Add documentation for invoicing of sales orders." instead of For instance, "Fix a typo"
or "Add documentation for invoicing of sales orders".
closesodoo/documentation#3735
X-original-commit: da87d72167
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
A translator notified me that one of the sentences in English made no
sense, so I'm fixing it to 1) make sense now 2) make it easier for the
translator.
Small fix, this page will be depecrated when I have time to make a new
one.
Forward to master.
closesodoo/documentation#3710
Taskid: 3211784
X-original-commit: f4ede744ae
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
The extension adds two new directive:
- `cards` is the row container for one or more `card` directives.
- `card` is the implementation of a Bootstrap card that accepts a
`target` argument for the href of the card, a `large` option to render
the card on two columns, a `tag` option to display a single arbitrary
tag on the card, and arbitrary content that is shown in the card
body.
task-3141419
closesodoo/documentation#3688
X-original-commit: 34bc63d2bc
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit also replaces references to the "Building a module"
tutorial by references to the "Getting started" tutorial.
task-2991663
X-original-commit: 4f4e346953
Part-of: odoo/documentation#3659
Added a shipping page to the eCommerce section. Forward to master.
closesodoo/documentation#3641
Taskid: 3111638
X-original-commit: 470e74492f
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
This commit changes the characters used as heading delimiters in the
/legal/ folder of the documentation. This makes it easier for writers to
figure out the heading order as all other files in this repository use
the same order of heading delimiters characters.
closesodoo/documentation#3626
X-original-commit: bab84c61a0
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
This PR change the cheat sheet of the accounting documentation.
Change done:
* Change name of the file: memento to cheat_sheet
* Adding explanation to the doc (Ex: Invoices and bills status)
* Correcting some sentences
closesodoo/documentation#3624
Task-id: 2847663
X-original-commit: 2fa9de17e1
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Those components were added during the Owl rewrite of the webclient
that happened in 16.0. Unfortunately, there was still no documentation
for them.
This commits fixes that by adding documentation for the Notebook and
the Colorlist components.
closesodoo/documentation#3585
X-original-commit: 7a9d807bcc
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Luca Vitali <luvi@odoo.com>
RST cleanup to comply with the RST guidelines. This is required so we
can use "make test", as there are currently hundreds of errors. For now,
it is unusable because of the oldest code in this repo.
closesodoo/documentation#3584
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Adding a cross/upselling page for the ecommerce section. Forward to
master.
closesodoo/documentation#3577
Taskid: 3142720
X-original-commit: 4db98bd840
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
This commit adds the documentation for the SelectMenu component, introduced
in saas-16.1. This documentation gives some example of its usage.
An image is also added, to better illustrate the grouping functionality.
closesodoo/documentation#3573
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
The content written in the fiscal localisation pages are not only for
Accounting, but also for other apps such as Payroll and Point of Sales.
This commit moves the content to the "Finance" level, to better reflect
this reality, and merges the pages in the /overview/ folder in the main
category page.
closesodoo/documentation#3558
X-original-commit: ecbb755471
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Friday afternoon cleanup. This is required so we can use "make test", as
there are currently hundreds of errors. For now, it is unusable because
of the oldest code in this repo.
closesodoo/documentation#3543
X-original-commit: 26ddeef42c
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Adding a documentation on payment providers specifically for the
ecommerce section.
closesodoo/documentation#3520
Taskid: 3138597
X-original-commit: 6b45da21c1
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Adding new page on checkout process for eCommerce. Forward to master.
closesodoo/documentation#3512
Taskid: 3110554
X-original-commit: 17ee191156
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Adding a project creation and management page for the project app. Forward to master.
closesodoo/documentation#3508
Taskid: 3117349
X-original-commit: 1689b80470
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Since 16.0, the documentation for this component was no longer
correct, since the component was moved to web during the refactor
of the webclient views. This commit also adds documentation of
props that were introduced during the refactor, already present
in 16.0.
closesodoo/documentation#3506
X-original-commit: fc79df42fd
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Adding a new page on eWallets and gift cards programs for the Sales app
documentation.
closesodoo/documentation#3497
Taskid: 3086636
X-original-commit: 9049013dde
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Adding add to cart page to the eCommerce section. Forward to master.
closesodoo/documentation#3495
Taskid: 3099603
X-original-commit: d09e6a83aa
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Previous page was mostly on the sales app. New page focuses on ecommerce
with :ref: to sales. Forward to master.
closesodoo/documentation#3492
Taskid: 3121379
X-original-commit: bd13d34bd6
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Adding a product page for the eCommerce section, currently does not
exist. V16, forward to master.
closesodoo/documentation#3481
Taskid: 2903859
X-original-commit: 5329cff046
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
Since commit
9431dddd7c,
the 'A-NZ BIS Billing 3.0' format is available for australian and new
zealand companies.
closesodoo/documentation#3482
X-original-commit: e2b4e8ad84
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Moving the Manage vendor bills page from the accounting app to the purchase app as it is
more relevant.
closesodoo/documentation#3455
Taskid: 2687652
X-original-commit: b5febf2299
Signed-off-by: Zachary Straub <zst@odoo.com>
The Service Level Agreement has to be updated. Any additional line of
code, without using studio, in standard modules is not supposed to be
covered by the upgrade team. It is slightly different than the point
telling "development of custom modules"
closesodoo/documentation#3449
X-original-commit: f469e4ef81
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
The outlook add-in URL was not updated
opw:3131547
closesodoo/documentation#3440
X-original-commit: d81513ed1c
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Simon Goffin <sig@odoo.com>
The maintenance fees cover the maintenance of the custom code (whoever
did it) and are not specifically dedicated to custom code written by
Odoo development teams
closesodoo/documentation#3421
X-original-commit: 92de7ccb2d
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
The goal of this commit is to propose a first step towards a new
`.. card::` directive for the toctrees. This is a first design
proposition for this new card component in raw html for the fallback
page `howtos.rst`
The long term objective is to redesign the toctrees by implementing card
components, clearer toctree list design and custom html pages.
Related to task-3059229
closesodoo/documentation#3407
X-original-commit: 64363d8640
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
The example for import order is a little confusing since it is wrong.
closesodoo/documentation#3380
X-original-commit: f7b1f66b8c
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Nicolas Lempereur (nle) <nle@odoo.com>
Removed old and probably not needed image of the dashboard showing the Contacts App
closesodoo/documentation#3344
X-original-commit: 4d3a10e8cd
Signed-off-by: Zachary Straub <zst@odoo.com>
Add a new content focused on SCSS and user-interface.
- SCSS coding guidelines: regroup information already available (eg [1])
or based on "oral tradition".
The aim is not to establish new rules, ~99% of the current codebase
is already compliant.
- SCSS inheritance: explain how SCSS assets management works in odoo.
For example, people still find confusing that overrides are defined
*before* the variable to customize.
- SCSS optimization tips: suggestions to lean SCSS code. Based on SCSS
optimization task's know-how [2].
- CSS variables: explain how this feature is commonly used in odoo to
adapt layout & design without raw CSS overrides.
- UI Icons: Add link to fontAwesome4 library . Replace the picture of
odoo icons with the actual font (90kb image VS 15Kb font)
[1] https://github.com/odoo/odoo/wiki/SCSS-coding-guidelines
[2] https://www.odoo.com/web#id=2704984&menu_id=4720&cids=1&model=project.task&view_type=form
task-3090800
closesodoo/documentation#3327
X-original-commit: 2ca32b40bc
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit adds the chapter 3,4,5,6 and 7 of the JavaScript web
framework tutorial.
This new tutorial allows people to discover Owl and the building blocks
of the Odoo JavaScript framework.
closesodoo/documentation#3325
X-original-commit: 54628b4f5b
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Géry Debongnie <ged@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit updates the documentation of the position hook, to add
the latest variant "fit". This variant was introduced recently in
commit (1), when using it in the SelectMenu component.
(1): c21c415f38closesodoo/documentation#3261
Signed-off-by: Luca Vitali <luvi@odoo.com>
This commit brings the documentation for the useSpellCheck hook,
introduced in commit (1). The documentation contains some example
and details on how to use the hook properly.
(1): 130719e584
Part-of: odoo/documentation#3261
The lists of supported currencies by payment provider are displayed on
the form view and are editable, because our list may not be up-to-date.
Empty lists stand for "no filtering" on the payment providers to access
payment methods.
task-2926016
closesodoo/documentation#2788
Related: odoo/enterprise#34158
Related: odoo/odoo#101018
Related: odoo/upgrade#4069
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit add the documentation for the new 'kanban-menu' template
(the ellipsis dropdown menu).
No that, this commit add also the documentation for the 'kanban-tooltip'
template.
closesodoo/documentation#3284
Task-id: 3096776
Related: odoo/odoo#107589
Related: odoo/enterprise#34962
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit restructures the contributing/documentation page to re-use
content introduced with the contributing/development page and to
display the two ways to contribute (github vs git) in content tabs
rather than sections.
The guide is simplified and updated to delegate long explanations to
other pages or websites, remove useless images and focus on getting
users ready to contribute.
task-2897123
Part-of: odoo/documentation#3265
In addition, this commit extracts the git guidelines from the coding
guidelines. This helps link the git guidelines and unclutter the coding
guidelines, which should focus on only the programming languages.
task-2897123
Part-of: odoo/documentation#3265
If committed, this will add a more elaborate warning on what users must
do before syncing Odoo Calendar and Outlook Calendar. It also removes
mentions of the import/export process and archiving events, as these
methods will not prevent email spam from Outlook.
closesodoo/documentation#3234
X-original-commit: 5979a772e6
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Michelle (mivu) <mivu@odoo.com>
This commit adds several small information on chapter 1 of the training
owl:
- 1.1 How to get to the playground controller
- 1.2 Add a reference on sub component
- 1.4 How to activate the dev mode in owl
closesodoo/documentation#3194
X-original-commit: 1bd7e803e0
Signed-off-by: Dardenne Florent (dafl) <dafl@odoo.com>
Added a note on packages and extensions support
closesodoo/documentation#3188
Taskid: 2836438
X-original-commit: b1f92ba879
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
In chapter 14 there was a line pointing to how to deduce a default journal for an `account.move` record.
This is no longer needed as the journal is automatically deduced using the `move_type`. Also, the link
point to an outdated line of code that causes an error.
closesodoo/documentation#3183
X-original-commit: 67a75a3e11
Signed-off-by: Horacio Tellez Perez (hote) <hote@odoo.com>
This commit replaces hard-coded occurrences of the version and of the
last, current and next releases' version with placeholders interpolated
at build time to avoid manually updating these after each freeze.
task-2917614
closesodoo/documentation#3170
X-original-commit: fa2d0f6363
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit adds the chapter 2 of the JavaScript tutorial.
This new tutorial allows people to discover Owl and the building blocks
of the Odoo JavaScript framework.
closesodoo/documentation#3164
X-original-commit: c5c6daef22
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Dardenne Florent (dafl) <dafl@odoo.com>
Co-authored-by: Géry Debongnie <ged@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
