documentation/content/contributing/documentation
Antoine Vandevenne (anv) cf6ca0fbb2 [IMP] contributing/doc, install: add an extension for content tabs
In many places in the docs, we need to document several flows that
differ only by a few details. For example, the steps to install Odoo
from the sources are almost identical for Windows, Linux, and Mac OS.
In other places, we'd want to suggest a command in different
environments or programming languages, etc.

This commit thus adds an extension for content tabs (tabs within the
content) to help reduce content repetition in the documentation. As a
proof of concept, the "Packaged installers" and "Source install"
sections of the "Installing Odoo" page are reworked to present their
content within tabs whenever it helps clarify the instructions.

A new python dependency is added as of this commit: `sphinx-tabs`

task-2713983

closes odoo/documentation#1528

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Lucie Van Nieuwenhuyse (luvn) <luvn@odoo.com>
2022-02-07 16:44:01 +00:00
..
content_guidelines [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
rst_cheat_sheet [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
commit-changes.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
compare-across-forks.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
content_guidelines.rst [IMP] contributing: encourage flat pages hierarchy 2021-06-11 10:52:35 +02:00
create-pull-request.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
fork-button.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
fork-repository.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
new-pull-request.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
rst_cheat_sheet.rst [IMP] contributing/doc, install: add an extension for content tabs 2022-02-07 16:44:01 +00:00
rst_guidelines.rst [MERGE] Forward-port of branch 14.0 to master 2021-06-07 09:18:35 +02:00
select-branches-base.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00
select-branches-fork.png [IMP] contributing: flatten hierarchy of "documentation" pages 2021-06-04 17:44:23 +02:00