From 0bf6aa2d6bcf0fb9135bd7a33033905b4e8cfc82 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Krier?= <ced@b2ck.com>
Date: Wed, 29 Jul 2026 18:13:09 +0200
Subject: [PATCH] Update documentation of web shop module

---
 modules/web_shop/CHANGELOG        |   4 ++
 modules/web_shop/doc/design.rst   | 106 ++++++++++++++++++++++++++++++
 modules/web_shop/doc/index.rst    |   9 ++-
 modules/web_shop/doc/releases.rst |   7 ++
 modules/web_shop/tryton.cfg       |   1 +
 5 files changed, 126 insertions(+), 1 deletion(-)
 create mode 100644 modules/web_shop/doc/design.rst
 create mode 100644 modules/web_shop/doc/releases.rst

diff --git a/modules/web_shop/CHANGELOG b/modules/web_shop/CHANGELOG
index e56926b728..88b3b6f1f4 100644
--- a/modules/web_shop/CHANGELOG
+++ b/modules/web_shop/CHANGELOG
@@ -47,16 +47,20 @@ Version 6.6.0 - 2022-10-31
 * Bug fixes (see mercurial logs for details)
 
 Version 6.4.0 - 2022-05-02
+--------------------------
 * Bug fixes (see mercurial logs for details)
 * Add support for Python 3.10
 * Remove support for Python 3.6
 
 Version 6.2.0 - 2021-11-01
+--------------------------
 * Bug fixes (see mercurial logs for details)
 * Add web shop check box to product image
 
 Version 6.0.0 - 2021-05-03
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 5.8.0 - 2020-11-02
+--------------------------
 * Initial release
diff --git a/modules/web_shop/doc/design.rst b/modules/web_shop/doc/design.rst
new file mode 100644
index 0000000000..cbaee027f4
--- /dev/null
+++ b/modules/web_shop/doc/design.rst
@@ -0,0 +1,106 @@
+******
+Design
+******
+
+The *Web Shop Module* introduces some new concepts.
+
+.. _model-web.shop:
+
+Web Shop
+========
+
+The *Web Shop* is the main concept provided by the *Web Shop Module*.
+It stores the properties of the corresponding shop online such as the `Company
+<company:model-company.company>`, the `Currency
+<currency:model-currency.currency>`, the `Warehouses
+<stock:concept-stock.location.warehouse>` for the stock level and the `Products
+<product:concept-product>` sold.
+
+.. seealso::
+
+   Web Shops can be found by opening the main menu item:
+
+      |Sales --> Configuration --> Web Shops|__
+
+      .. |Sales --> Configuration --> Web Shops| replace:: :menuselection:`Sales --> Configuration --> Web Shops`
+      __ https://demo.tryton.org/model/web.shop
+
+
+.. _model-web.user:
+
+Web User
+========
+
+When the *Web Shop Module* is activated, the users gain new properties storing
+the default invoice and shipment `address <party:model-party.address>`.
+
+.. seealso::
+
+   The `Web User <web_user:model-web.user>` concept is introduced by the
+   :doc:`Web User Module <web_user:index>`.
+
+.. _concept-product:
+
+Product
+=======
+
+When the *Web Shop Module* is activated, the products gain new properties used
+to publish on the web shop.
+
+.. seealso::
+
+   The `Product <product:concept-product>` concept is introduced by the
+   :doc:`Product Module <product:index>`.
+
+.. _model-product.category:
+
+Product Category
+================
+
+When the *Web Shop Module* is activated, the product categories gain a list of
+`web shops <model-web.shop>` on which they must be published.
+
+.. seealso::
+
+   The `Product Category <product:model-product.category>` concept is
+   introduced by the :doc:`Product Module <product:index>`.
+
+.. _model-product.attribute:
+
+Product Attribute
+=================
+
+When the *Web Shop Module* is activated, the product attributes gain a list of
+`web shops <model-web.shop>` on which they must be published.
+
+.. seealso::
+
+   The `Product Attribute <product_attribute:model-product.attribute>` concept
+   is introduced by the :doc:`Product Attribute Module
+   <product_attribute:index>`.
+
+.. _model-product.image:
+
+Product Image
+=============
+
+When the *Web Shop Module* is activated, the product image gains a
+:guilabel:`Web Shop` checkbox to indicate if the image must be published.
+
+.. seealso::
+
+   The `Product Image <product_image:model-product.image>` concept is
+   introduced by the :doc:`Product Image Module <product_image:index>`.
+
+.. _model-sale.sale:
+
+Sale
+====
+
+When the *Web Shop Module* is activated, the sale gains new properties to store
+the relations with the web shop.
+
+.. seealso::
+
+   The `Sale <sale:model-sale.sale>` concept is introduced by the :doc:`Sale
+   Module <sale:index>`.
diff --git a/modules/web_shop/doc/index.rst b/modules/web_shop/doc/index.rst
index ca1a1a8572..98592c1b76 100644
--- a/modules/web_shop/doc/index.rst
+++ b/modules/web_shop/doc/index.rst
@@ -1,5 +1,12 @@
+###############
 Web Shop Module
 ###############
 
-The web_shop module provides facilities to store configuration of online web
+The *Web Shop Module* provides facilities to store configuration of online web
 shop.
+
+.. toctree::
+   :maxdepth: 2
+
+   design
+   releases
diff --git a/modules/web_shop/doc/releases.rst b/modules/web_shop/doc/releases.rst
new file mode 100644
index 0000000000..21b13c4745
--- /dev/null
+++ b/modules/web_shop/doc/releases.rst
@@ -0,0 +1,7 @@
+.. _releases-index:
+
+=============
+Release notes
+=============
+
+.. include:: ../CHANGELOG
diff --git a/modules/web_shop/tryton.cfg b/modules/web_shop/tryton.cfg
index 4d2cb34cd6..e40370875c 100644
--- a/modules/web_shop/tryton.cfg
+++ b/modules/web_shop/tryton.cfg
@@ -6,6 +6,7 @@ depends:
     country
     currency
     ir
+    party
     product
     sale
     stock