Commit Graph

114 Commits

Author SHA1 Message Date
Brandon Mercier
8ce27c696d [IMP] Website Themes - Going Live
[IMP] Website Themes - Going Live

- Content update and additions
- Screenshot
- New anchors

[FIX] Fix after code review

[FIX] Anchor to noupdate attribute

closes odoo/documentation#12225

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-15 15:37:50 +00:00
Brandon Mercier
2fc209623d [IMP] Website themes - Pages
[IMP] Website themes - Pages
[FIX] Website Themes - Pages: Anchors
[FIX] Website Themes - Pages: anchors
[FIX] Anchors patterns + code review modifications

closes odoo/documentation#12222

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 15:42:27 +00:00
Brandon Mercier
53b2db4ab5 [IMP] Website Themes - Layout page
[IMP] Website Themes - Layout page

[FIX] Corrections for ci

[FIX] Ci failure

[IMP] Small corrections

- Reorder the Xpath examples.
- Add an explanation for the move directive

[ADD] Website Themes - Media section

[IMP] Website Themes - Layout section modifications

[IMP] Anchors for CEDE's references (Tutorials)

[IMP] Line width + visibility conditions alert type

[IMP] Website Themes - Layout : Anchors correction

Revert "[ADD] Website Themes - Media section"

This reverts commit 4567cfe114251cdc9f263b8e97f0f988945f4db8.

[FIX] Update anchors pattern

[FIX] Media company logo reference

closes odoo/documentation#12220

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 15:42:25 +00:00
Brandon Mercier
1ef929990c [IMP] Website Themes - Building blocks
Rework of the whole page in order to organized / categorized the content better + Addition from the PSBE Designers Wiki

[FIX] Website Themes - Building block : Fix typo

[FIX] Corrections after review

closes odoo/documentation#12219

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 15:42:24 +00:00
Carlos Valverde
0044a6bb09 [ADD] howto/website: add media page
This commit adds the `media` page, links it to the `website_themes`
index, deletes duplicated content from the `pages.rst` page and moves
images from the current `pages` folder to a new one.

Task-4316611

closes odoo/documentation#12192

Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 11:56:08 +00:00
Carlos Valverde
a548d85da8 [IMP] howto/website: update navigation page
This commit updates current navigation page, by adding new anchor links
to the sections and by adding updated information.

Task-4316611

closes odoo/documentation#12191

Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 09:40:36 +00:00
Brandon Mercier
88301e22ea [IMP] Website Themes - Forms
[IMP] Website Themes - Forms
[FIX] Anchors + Modifications after code review

closes odoo/documentation#12224

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 09:40:35 +00:00
Carlos Valverde
4e0f298786 [IMP] howto/website: update shapes page
This commit updates current `shapes` page, by adding new anchor links
to the sections, updated information and images.

Task-4316611

closes odoo/documentation#12213

Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 09:40:33 +00:00
Carlos Valverde
0ea5823a94 [IMP] howto/website: update animations page
This commit updates current `animations` page, by adding new anchor
links to the sections, updated information and images.

Task-4316611

closes odoo/documentation#12235

Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-14 09:40:32 +00:00
Brandon Mercier
dab8e3c71e [IMP] Website Themes - Gradients
[IMP] Website Themes - Gradients

- Corrections
- New anchors

[FIX] Modifications after code review

closes odoo/documentation#12223

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 09:40:31 +00:00
Brandon Mercier
9d5ccb7e1d [IMP] Website Themes - Setup
[IMP] Website Themes - Setup

[IMP] Website Themes - Setup

- Use the right code-block language for terminal command line
- Add a step about the 2-factor authentication

[IMP] Anchors for CEDE's references (Tutorials)

[FIX] Website Themes - Setup: Anchors

[IMP] Anchors pattern correction

closes odoo/documentation#12221

Signed-off-by: Brandon Mercier (bram) <bram@odoo.com>
2025-03-14 07:31:26 +00:00
Carlos Valverde
e508d96c1d [IMP] howto/website: update translations page
This commit updates current `translations` page, by adding new anchor
links to the sections, updated information and images.

Task-431661

closes odoo/documentation#12236

Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-10 13:25:23 +00:00
Carlos Valverde
16e1bad7db [IMP] howto/website: update theming page
This commit updates current theming page, by adding new anchor links to
the sections and by adding updated information.

Task-4316611

closes odoo/documentation#12143

Signed-off-by: Carlos Valverde (cvs) <cvs@odoo.com>
2025-03-05 15:55:41 +00:00
samueljlieber
97f9ae1b95 [FIX] clean unused resource files
Part-of: odoo/documentation#12010
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-02-13 08:44:14 +00:00
xpl-odoo
efe4e4a4bc [IMP] upgrade: better introduce the upgrade process
closes odoo/documentation#10899

X-original-commit: fcf0b645d1
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2024-09-02 13:57:39 +00:00
Alvaro Fuentes
91a48bfe88 [IMP] doc: improve organization of upgrades docs
* Add autodoc directives to generate documentation directly from
  upgrade-util repo.
* Group all upgrades-related reference documentation into one group in
  the sidebar, instead of having two entries.
* Mention `upgrades` vs `migrations` directory. It has been supported
  since a while but nothing was explicit in the documentation.

closes odoo/documentation#8748

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2024-04-18 10:25:30 +00:00
Jonathan Castillo (jcs)
32aafb08cb [MOV] documentation structure reorganization
This commit aims to improve the documentation's navigability by
redefining some categories' purposes and titles.

There is a redirection rule for each documentation page moved.
This ensures that users won't have a 404 error message.

task-3217827

closes odoo/documentation#8056

Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2024-03-11 13:59:04 +00:00
Augusto Perez
16a209c750 [ADD] Upgrade documentation: Upgrade scripts and Util package
closes odoo/documentation#7330

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-01-25 12:56:20 +00:00
Nathan Marotte (nama)
44f4683519 [ADD] Upgrade documentation: How-to-guide for developers
closes odoo/documentation#6757

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-01-10 17:25:59 +00:00
Louis Baudoux
282f041ed1 [IMP] iap: remove documentation related to IAP services creation
It has been decided to remove the possibility for our users to create
their own IAP services.
This decision was motivated by the fact that, in the 5 years of
existence of IAP, very few non-Odoo services have been created and
actively used by our customers.

X-original-commit: 0c1b7c4636
Part-of: odoo/documentation#6298
2023-11-07 16:10:04 +00:00
Stan (stgu)
6f3ed657fc [IMP] howtos/translations: text & tips
Remove parenthesis around a term that's fairly straightforward to
understand and later used as a title Add a much-needed point.

closes odoo/documentation#5653

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-10-13 17:01:06 +00:00
fdardenne
c1c04f90a8 [IMP] Views howtos: add details on how to use a view in arch
closes odoo/documentation#5773

Signed-off-by: Florent Dardenne (dafl) <dafl@odoo.com>
2023-09-08 11:22:35 +00:00
Xavier (XPL)
da2a48b9fd [REF] install: move intro to main install page and split by install type
This PR moves the introduction about the different installation methods and editions found on the
install/install.rst page directly under the main install/ page. It creates three pages, one per
installation method documented on the install/install.rst page (Docker being documented on
docker.com and maintained by us), and moves the related content there. In addition, it fixes various
typos/grammar issues and improves the content according to the documentation guidelines. Various
references and links across the documentation had to be fixed accordingly.

task-3459070

closes odoo/documentation#5526

X-original-commit: 42a8f492e7
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-08-18 09:50:42 +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
CVDE-odoo
892fd3e2ac [ADD] developer/howto: guide for theming
A complete guide on how to create a custom website theme for Odoo

closes odoo/documentation#4399

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-11 20:37:08 +02:00
Mahmoud Metwally
9e6f4a8c56 [FW][FIX] howtos/company: fix typos
closes odoo/documentation#4176

Forward-port-of: odoo/documentation#4147
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-17 17:48:23 +02:00
Mahmoud Metwally
32c6bed34b [FW][FIX] developer/web_services: fix typo
closes odoo/documentation#4157

Forward-port-of: odoo/documentation#4146
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-14 12:47:22 +02:00
Tiffany Chang (tic)
7124542ed9 [REF] developer: rewrite sql view as a howto
SQL view was formerly part of the dashboard tutorial which is now
obsolete. Since creating a SQL view as a tutorial does not make sense
anymore, it has been converted into a simple howto.

closes odoo/documentation#4031

Task: 3226581
Signed-off-by: Tiffany Chang <tic@odoo.com>
2023-04-05 14:47:46 +02:00
fdardenne
7e4435deb8 [IMP] create JavaScript howtos
The JavaScript cheatsheet is outdated, we therefore remove it and
replace it by multiple howtos:

- Create a view from scratch
- Extending an existing view
- Create a field from scratch
- Extend an existing field
- Create a client action

There is other subjects to introduce as the web framework is big. Other
future contributions will cover them.

closes odoo/documentation#3969

Signed-off-by: Dardenne Florent (dafl) <dafl@odoo.com>
2023-04-04 16:06:19 +02:00
Antoine Vandevenne (anv)
95ed856446 [MOV] developer/api/external_api: move "External API" to the reference dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:17 +01:00
Antoine Vandevenne (anv)
b817e16a4c [MOV] developer/api/iap: move "In-App Purchase" to the howtos dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:16 +01:00
Antoine Vandevenne (anv)
2701d91db0 [MOV] developer/iot: move "Internet of things" the howtos dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:16 +01:00
Antoine Vandevenne (anv)
2d469bccbc [MOV] howto/web: move "Customizing the webclient" to the tutorials dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:16 +01:00
Antoine Vandevenne (anv)
58f2174c49 [MOV] howto/website: move "Building a website" to the tutorials dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:15 +01:00
Antoine Vandevenne (anv)
642c4839f7 [MOV] howtos/backend: move "Building a module" to the tutorials dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:15 +01:00
Antoine Vandevenne (anv)
9c5ea316ff [MOV] howtos/discover_js_framework/*: move "Discover the JS Framework" to the tutorials dir
task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:15 +01:00
Antoine Vandevenne (anv)
4f4e346953 [MOV] howto/rdtraining: move "Getting started" to the tutorials dir
This commit also replaces references to the "Building a module"
tutorial by references to the "Getting started" tutorial.

task-2991663

Part-of: odoo/documentation#3655
2023-02-23 14:33:14 +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
Amelia Williams
18b000602b [FIX] 02_setup: remove gramatical error
closes odoo/documentation#3579

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-15 11:46:43 +01:00
Mahmoud Metwally
7913fd7bdd [FW][FIX] developer/howtos: typos and phrasing
closes odoo/documentation#3555

Forward-port-of: odoo/documentation#3541
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2023-02-13 14:53:07 +01:00
fdardenne
a70665ef34 [FIX] developer: remove merge text in chapter 6
closes odoo/documentation#3348

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-18 11:49:18 +01:00
stefanorigano (SRI)
2ca32b40bc [IMP] scss: update, improve preexisting content
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

closes odoo/documentation#3093

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-12 18:19:27 +01:00
fdardenne
54628b4f5b [IMP] developer: JavaScript tutorial: chapter 3-7
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.

closes odoo/documentation#3222

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>
2023-01-12 16:00:50 +01:00
Mahmoud Metwally
9c9c20110c [FIX] rdtraining: fix writing errors
closes odoo/documentation#3266

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-03 19:07:18 +01:00
Antoine Vandevenne (anv)
8d94f66d81 [ADD] contributing/development: add a guide to contribute to the codebase
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#3260
2023-01-03 13:27:05 +01:00
oco-odoo
bf2d3d9ed2 [IMP] accounting: full documentation of the new report engine
Engine report for accounting.

closes odoo/documentation#2784

Taskid: 3042880
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2022-12-21 16:55:24 +01:00
fdardenne
1bd7e803e0 [IMP] developer: JavaScript tutorial: enhance chapter 1
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

closes odoo/documentation#3177

Signed-off-by: Dardenne Florent (dafl) <dafl@odoo.com>
2022-12-14 17:56:07 +01:00
Horacio Tellez
924e6a2339 [FIX] rdtraining: remove outdated line about journal_id in chapter 14
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.

closes odoo/documentation#3182

X-original-commit: 67a75a3e11
Signed-off-by: Horacio Tellez Perez (hote) <hote@odoo.com>
2022-12-12 09:55:44 +01:00
Antoine Vandevenne (anv)
fa2d0f6363 [IMP] conf.py, *: interpolate the version and releases in the content
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

closes odoo/documentation#3166

X-original-commit: 12e1085199
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-12-09 10:40:06 +01:00
fdardenne
c5c6daef22 [IMP] developer: JavaScript tutorial: chapter 2
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.

closes odoo/documentation#3105

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>
2022-12-08 16:43:13 +01:00