Commit Graph

122 Commits

Author SHA1 Message Date
Jess Rogers (jero)
c24f4b237e [IMP] live chat:update getting started doc
closes odoo/documentation#4024

Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
2023-06-26 17:19:28 +02:00
“Audrey
9e453285d0 [IMP] Website: Multiple websites
task-3190493

closes odoo/documentation#4509

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-12 18:06:28 +02:00
Jonathan Castillo (jcs)
ebeebbcd45 [MOV] accounting: restructuration of the accounting documentation
This commit improves the structure of the accounting documentation by
- reducing the levels necessary to reach the information
- grouping some docs
- moving content to their parent category page (content in all levels)
- renaming some sections to reflect the structure of the app better

task-3330093

closes odoo/documentation#4470

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-20 08:26:00 +02:00
“Audrey
15d8985d33 [ADD] website: cookies bar
Task ID: 3297795

closes odoo/documentation#4315

Related: odoo/odoo#120639
Signed-off-by: auva-odoo <auva@odoo.com>
2023-05-05 15:35:06 +02:00
Jonathan Castillo (jcs)
e28ca153cb [MOV] live chat: structure
task-3269837

closes odoo/documentation#4107

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-11 21:54:07 +02:00
Jonathan Castillo (jcs)
8b13e1b0dc [MOV] website: structure
As a first step to update the doc - at last! - we first need to update
its structure.

task-3269837

Part-of: odoo/documentation#4107
2023-04-11 21:54:07 +02:00
Tom Aarab (toaa)
4c623b69b1 [ADD] ecommerce: performance monitoring
Adding a doc page on performance monitoring and analysis for eCommerce
websites

closes odoo/documentation#3866

Taskid: 3246984
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
2023-04-04 16:06:16 +02:00
“Audrey
67bada80e6 [IMP] Website: review website translation page
task-3255779

closes odoo/documentation#3973

Signed-off-by: auva-odoo <auva@odoo.com>
2023-03-31 18:37:51 +02:00
Tom Aarab (toaa)
c24f6eca7a [ADD] eCommerce: customer interaction
Adding a page on customer interaction and adding redirects. Forward to
master.

closes odoo/documentation#3775

Taskid: 3224716
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-03-21 12:36:49 +01:00
Tom Aarab (toaa)
49b45c9aa6 [ADD] eCommerce: customer accounts
Adding a page on customer accounts for the eCommerce doc. Forward to
master.

closes odoo/documentation#3769

Taskid: 3223001
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-03-09 19:34:21 +01:00
Tom Aarab (toaa)
f6fa482087 [ADD] eCommerce: Handling orders
Adding a page on handling orders for the eCommerce doc, and removing
older pages. Forward to master.

closes odoo/documentation#3721

Taskid: 3214065
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-03-08 09:10:40 +01:00
Tom Aarab (toaa)
70267f4535 [IMP] eCommerce: ewallets/giftcards section
Adding ewallets/giftcards section to the eCommerce doc. Forward to
master.

closes odoo/documentation#3739

Taskid: 3215674
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-03-07 12:44:58 +01:00
Tom Aarab (toaa)
b7db89e77b [IMP] ecommerce: add custom anchors, links and "see also" sections
This commit adds custom anchors, links and new see also sections

task-3212218

closes odoo/documentation#3712

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-03-02 10:16:17 +01:00
Tom Aarab (toaa)
1bd7d2d3b3 [FIX] website: syntax error (fix for translators)
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.

closes odoo/documentation#3709

Taskid: 3211784
X-original-commit: f4ede744ae
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-03-01 17:36:36 +01:00
Antoine Vandevenne (anv)
3dc6bb83c1 [MOV] developer/cli: move "Command-line interface (CLI)" to the reference dir
task-2991663

closes odoo/documentation#3655

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-23 14:33:17 +01:00
Tom Aarab (toaa)
470e74492f [ADD] eCommerce: shipping page
Added a shipping page to the eCommerce section. Forward to master.

closes odoo/documentation#3229

Taskid: 3111638
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-20 18:38:18 +01:00
Tom Aarab (toaa)
d43a9b2598 [ADD] eCommerce: new price management page
Current documentation doesn't feature any pricing management info.
Forward to master.

closes odoo/documentation#3046

Taskid: 3086649
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-17 10:55:29 +01:00
Jonathan Castillo (jcs)
17319f92b2 [FIX] *: RST cleanup
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.

closes odoo/documentation#3581

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-02-15 12:51:21 +01:00
Tom Aarab (toaa)
4db98bd840 [ADD] ecommerce: cross and upselling page
Adding a cross/upselling page for the ecommerce section. Forward to
master.

closes odoo/documentation#3367

Taskid: 3142720
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-14 17:04:07 +01:00
Tom Aarab (toaa)
6b45da21c1 [ADD] ecommerce: new payment providers page
Adding a documentation on payment providers specifically for the
ecommerce section.

closes odoo/documentation#3346

Taskid: 3138597
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-09 13:01:58 +01:00
Tom Aarab (toaa)
17ee191156 [ADD] eCommerce: checkout process page
Adding new page on checkout process for eCommerce. Forward to master.

closes odoo/documentation#3192

Taskid: 3110554
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-09 08:12:58 +01:00
Tom Aarab (toaa)
d09e6a83aa [ADD] eCommerce: add to cart page
Adding add to cart page to the eCommerce section. Forward to master.

closes odoo/documentation#3175

Taskid: 3099603
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-07 11:49:35 +01:00
Tom Aarab (toaa)
bd13d34bd6 [IMP] ecommerce: updated variants page
Previous page was mostly on the sales app. New page focuses on ecommerce
with :ref: to sales. Forward to master.

closes odoo/documentation#3299

Taskid: 3121379
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-06 18:33:00 +01:00
Tom Aarab (toaa)
5329cff046 [ADD] eCommerce: add product page
Adding a product page for the eCommerce section, currently does not
exist. V16, forward to master.

closes odoo/documentation#3112

Taskid: 2903859
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-02-03 14:58:44 +01:00
Tom Aarab (toaa)
029b5a183b [IMP] ecommerce: updated catalog page
Updated catalog page. Forward to master.

closes odoo/documentation#2971

Taskid: 3071640
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-01 18:19:42 +01:00
Victor Feyens
1b811f8de8 [FIX] *: unbalanced literal markups
Part-of: odoo/documentation#2983
2022-11-18 20:30:01 +01:00
Victor Feyens
c367974170 [FIX] *: remove trailing whitespaces
Part-of: odoo/documentation#2983
2022-11-18 20:30:01 +01:00
Victor Feyens
968ed0a17a [FIX] *: enforce 1 newline on files end
Part-of: odoo/documentation#2983
2022-11-18 20:30:00 +01:00
Jonathan Castillo (jcs)
2c17b6fb4a [IMP] *: consistency for the use of "Odoo Online" (and SaaS)
task-3034812

Part-of: odoo/documentation#2836
2022-10-21 16:19:58 +02:00
nbe-odoo
87392b7262 [FIX] website: rst and file organization for plausible.rst
- external links
- notes
- indentation
- media filenames
- images compression
- images alt tags
- light content improvement

closes odoo/documentation#2820

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
Co-authored-by: Nicolas Bebawi (nbe) <nbe@odoo.com>
Co-authored-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2022-10-20 15:44:12 +02:00
Horacio Tellez
a83d44239a [IMP] finance,*: change of the term "acquirer" to "provider"
Changing the name of model payment.acquirer to payment.provider
and everything that it touches. It is technically incorrect to
use the term "acquirer" for systems that only provide a service
of payment.
After this commit the model payment.acquirer and everything
related to it will be renamed to payment.provider.

Task - 2842088

closes odoo/documentation#1981

Related: odoo/upgrade#3542
Related: odoo/odoo#90899
Related: odoo/enterprise#27131
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-09-09 13:38:04 +02:00
Romain Derie
f1e3c2d81d [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#2499

X-original-commit: 0d01565ac3
Related: odoo/odoo#96280
Related: odoo/enterprise#29666
Related: odoo/upgrade#3698
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Romain Derie (rde) <rde@odoo.com>
2022-07-26 15:48:50 +02:00
“Lau-Odoo”
3f2334fda3 [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#2420

X-original-commit: 7307dac6a6
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-07 18:43:45 +02:00
Ludvig Auvens
9d419b67ae [IMP] eCommerce: update of cross-selling doc for Odoo 15.0 and after.
closes odoo/documentation#2394

X-original-commit: db8b45ead2
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-06 21:22:59 +02:00
Antoine Vandevenne (anv)
cb8d65d5e3 [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#2381

X-original-commit: 12ff9f118b
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-04 17:47:43 +02:00
“Lau-Odoo”
11996a97bc [IMP] website: broken link removal
task - 2841794

closes odoo/documentation#2365

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 16:36:26 +02:00
Antoine Vandevenne (anv)
e8e75d4175 [IMP] payment_acquirers: explain the different additional features
task-2862636

closes odoo/documentation#2121

X-original-commit: c820aa4951
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-06-01 14:16:04 +02:00
Antoine Vandevenne (anv)
8722ea902e [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#2068
2022-05-20 14:18:54 +02:00
Jeremy Kersten
eb28322572 [ADD] websites: add plausible.io Dashboard documentation
closes odoo/documentation#2007

Related: odoo/odoo#91058
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-05-18 20:33:37 +02:00
root
f3a541ad73 [ADD] multi_website: add info to configure multiple domains
closes odoo/documentation#1898

X-original-commit: 324936c43e
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-04-29 11:01:50 +02:00
Jonathan Castillo (jcs)
3c552336da [IMP] install/maintain: new improved doc about domain names
task-id 2680490

closes odoo/documentation#1651

X-original-commit: cda64e2678
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-03-03 17:54:35 +00:00
BVE
f2179ad8a0 [ADD] email_communication: new documentation regarding general emailing
Creation of a new submenu under Applications/General for the Email communication.
Moved advanced of dicuss to this new submenu + adding of content regarding
frequently asked question in support.

Redirection has been done on other files pointing to Discuss/Advanced to match
the new folder email_communication.

Modified content in:
- Email servers: split and move configuration part under email_domain
- Email domain: covering information about SPF DKIM and DMARC configurations by JQU
- Email templates: (how to use the functions) by GOR
- Email common: answering frequently asked questions + common issues by ALA

closes odoo/documentation#1550

X-original-commit: ce8a02d46a
Signed-off-by: Vergote Baptiste (bve) <bve@odoo.com>
2022-02-07 12:11:43 +00:00
Jonathan Castillo (jcs)
4e0c62ae03 [MOV] payment acquirers: from /general/ (misc. section) to /finance/
The "Payment Acquirers" category was moved to the /general/ folder
(Miscellaneous section) when the super-categories such as "Finance"
didn't exist yet. Now, it makes more sense to move this category to
"Finance".

task-id 2743227

X-original-commit: cbe6aad9e9
Part-of: odoo/documentation#1507
2022-01-28 13:33:13 +00:00
Jonathan Castillo (jcs)
3e674f3178 [IMP] website: update a wrong link (godaddy)
task-id 2682327

closes odoo/documentation#1286

X-original-commit: edb747bca1
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2021-11-03 16:16:40 +00:00
Antoine Vandevenne (anv)
be1653cc51 [MERGE] Forward-port of branch 13.0 to 14.0 2021-07-07 15:39:35 +02:00
Fabien Pinckaers
16418c020b [IMP] *: introduce tables of contents in top-level app pages 2021-07-07 14:56:38 +02:00
Antoine Vandevenne (anv)
245dd60bb4 [MERGE] Forward-port of branch 13.0 to 14.0 2021-06-25 15:59:04 +02:00
Kevin Scannell
ce9e496873 [IMP] ecommerce: update 'product variants'
task-2486400
2021-06-21 11:07:59 +02:00
Antoine Vandevenne (anv)
cffb0b341a [MERGE] Forward-port of branch 13.0 to 14.0 2021-06-11 17:04:01 +02:00
rjo-odoo
015f456d80 [IMP] website: minor sentence modification in "domain_name" 2021-06-09 14:36:49 +02:00
Antoine Vandevenne (anv)
b30f28a3c4 [MERGE] Forward-port of branch 13.0 to 14.0 2021-06-09 12:22:50 +02:00
Antoine Vandevenne (anv)
251438d569 [MERGE] Forward-port of branch 12.0 to 13.0 2021-06-09 12:10:06 +02:00
Antoine Vandevenne (anv)
1d3375f1a8 [IMP] *: exclude empty TOC pages from search results
When searching for a string that can be found in a TOC page's content,
that page is listed in the search results. This is not a wanted behavior
because TOC pages without the 'show-content' metadata directive are not
supposed to be accessible.

This commit adds a 'nosearch' metadata directive to all TOC pages
without a 'show-content' metadata directive, hence removing them from
search results.

task-2527419
2021-06-09 11:55:34 +02:00
Jonathan Castillo
08f8a3d0c0 [REM] content/applications/*: delete unused images 2021-06-09 09:58:59 +02:00
Jonathan Castillo
193e22492c [MERGE] Forward-port of branch 13.0 to 14.0 2021-06-04 17:21:14 +02:00
Jonathan Castillo
2fb77cf3ff [MOV] general: removes main "settings" section + move content
This commit is part of a larger work to improve the documentation's
structure. The toctree structure used to add levels to create categories
and make the structure visually more understandable.
With the new version of the documentation, plenty of these categories
are now redundant.

This commit:
- removes the main "settings" section
  - move its content to general/odoo_basics
- moves "general/mobile" content to "general"
- moves the content of the doc "developer_mode/activate" to "general"
  - it replaces the references to that doc with `:ref:` directives
    rather than `:doc:` directives
  - it is worth noting that it also fixes plenty of links that
    previously referred to "developer_mode" (the category) rather than
	"developer_mode/activate" (the document)

task-2535899
2021-06-04 13:51:18 +02:00
Jonathan Castillo
2b6f89f26e [MOV] general: move "payment_acquirer" content up to its parent page
This commit is part of a larger work to improve the documentation's
structure. The toctree structure used to add levels to create categories
and make the structure visually more understandable.
With the new version of the documentation, plenty of these categories
are now redundant.

This commit improves the structure of the "general" section:
- moves the content of "payment_acquirers/payment_acquirers" to its
  parent page, as main content for this category.

It also improves the content of the note about sensitive data.

task-2535899
2021-06-04 13:51:18 +02:00
Victor Feyens
a1e7024fa0 [MERGE] Forward-port of branch 13.0 to 14.0 2021-05-31 15:16:09 +02:00
Victor Feyens
40afc9d9f0 [MERGE] Forward-port of branch 12.0 to 13.0 2021-05-31 14:54:23 +02:00
Victor Feyens
becf7a207d [FIX] content/applications/*: typos
found with codespell
2021-05-31 14:44:18 +02:00
Romaric PINSET LEPRETRE
2f4c713be1 [FIX] app/website: Gengo isn't supported in v14 anymore
Cf. https://github.com/odoo/odoo/pull/58678#issuecomment-700627182
2021-05-31 13:29:58 +02:00
Victor Feyens
8ad392222b [MERGE] Forward-port of branch 13.0 to 14.0 2021-05-17 19:00:31 +02:00
Victor Feyens
87ab494b42 [MERGE] Forward-port of branch 12.0 to 13.0 2021-05-17 18:29:11 +02:00
Victor Feyens
dc49cd9e7b [IMP] *: links improvements
* use absolute paths when cleaner than relative paths
* fix some sphinx issues / todos
2021-05-17 15:32:24 +02:00
Victor Feyens
326de4b39e [FIX] *: absolute links to odoo.com/documentation 2021-05-17 15:32:24 +02:00
Victor Feyens
6aea496f26 [MERGE] Forward-port of branch 13.0 to 12.0 2021-05-11 15:25:37 +02:00
KC (ksc)
e976c19b96 [REM] ecommerce: intro to ecommerce
Removes unnecessary, straightforward, easy-to-figure out documentation, as part of an effort to '
clear out any sort of documentation that is either too easy, too simple,
or already gone over in the tutorial videos. This documentation falls into that category. Hence,
it was removed entirely.
2021-05-10 10:52:45 +02:00
KC (ksc)
128d9f2136 [IMP] ecommerce: updates mention about inventory app in "show product availability"
As per the documentation, it is possible to show inventory availability under ecommerce without
installing Inventory app which is incorrect. Made the appropriate changes.
2021-05-10 08:52:18 +02:00
KC (ksc)
96b62b62fb [IMP] ecommerce: updates doc about managing orders w/ Payment Acquirers 2021-05-05 16:45:54 +02:00
Antoine Vandevenne (anv)
74c9f94d16 [MERGE] Forward-port of branch 13.0 to 14.0 2021-05-04 16:51:07 +02:00
Antoine Vandevenne (anv)
8a6ad77935 [MERGE] Forward-port of branch 12.0 to 13.0 2021-05-04 16:31:06 +02:00
Antoine Vandevenne (anv)
e3fee2cf46 [REF][MOV] documentation apocalypse
Prior to this commit, the Odoo documentation was mainly split between
two repositories: odoo/odoo/doc and odoo/documentation-user. Some bits
of documentation were also hosted elsewhere (e.g., wiki, upgrade, ...).
This was causing several problems among which:
  - The theme, config, Makefile, and similar technical resources had to
    be duplicated. This resulted in inconsistent layout, features, and
    build environments from one documentation to another.
  - Some pages did not fit either documentation as they were relevant
    for both users and developers. Some were relevant to neither of the
    two (e.g., DB management).
  - Cross-doc references had to be absolute links and they broke often.
  - Merging large image files in the developer documentation would bloat
    the odoo/odoo repository. Some contributions had to be lightened to
    avoid merging too many images (e.g., Odoo development tutorials).
  - Long-time contributors to the user documentation were chilly about
    going through the merging process of the developer documentation
    because of the runbot, mergebot, `odoo-dev` repository, etc.
  - Some contributors would look for the developer documentation in the
    `odoo/documentation-user` repository.
  - Community issues about the user documentation were submitted on the
    `odoo/odoo` repository and vice-versa.

Merging all documentations in one repository will allow us to have one
place, one theme, one work process, and one set of tools (build
environment, ...) for all of the Odoo docs.

As this is a good opportunity to revamp the layout of the documentation,
a brand new theme replaces the old one. It features a new way to
navigate the documentation, centered on the idea of always letting the
reader know what is the context (enclosing section, child pages, page
structure ...) of the page they are reading. The previous theme would
quickly confuse readers as they navigated the documentation and followed
cross-application links.

The chance is also taken to get rid of all the technical dangling parts,
performance issues, and left-overs. Except for some page-specific JS
scripts, the Odoo theme Sphinx extension is re-written from scratch
based on the latest Sphinx release to benefit from the improvements and
ease future contributions.

task-2351938
task-2352371
task-2205684
task-2352544

Closes #945
2021-05-04 15:44:00 +02:00