From 7d51113405b9930672224c6aafd9ebeef2c9b05a Mon Sep 17 00:00:00 2001
From: Sergi Almacellas Abellana <sergi@kopen.es>
Date: Mon, 30 Mar 2026 22:20:54 +0200
Subject: [PATCH] Update documentation of production work timesheet module

---
 modules/production_work_timesheet/CHANGELOG   | 12 +++++++
 .../production_work_timesheet/doc/design.rst  | 35 +++++++++++++++++++
 .../production_work_timesheet/doc/index.rst   | 11 ++++--
 .../doc/releases.rst                          |  7 ++++
 4 files changed, 63 insertions(+), 2 deletions(-)
 create mode 100644 modules/production_work_timesheet/doc/design.rst
 create mode 100644 modules/production_work_timesheet/doc/releases.rst

diff --git a/modules/production_work_timesheet/CHANGELOG b/modules/production_work_timesheet/CHANGELOG
index d3cf8ce2c1..7b9b538b5d 100644
--- a/modules/production_work_timesheet/CHANGELOG
+++ b/modules/production_work_timesheet/CHANGELOG
@@ -38,41 +38,53 @@ 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)
 
 Version 6.0.0 - 2021-05-03
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 5.8.0 - 2020-11-02
+--------------------------
 * Bug fixes (see mercurial logs for details)
 * Remove support for Python 3.5
 
 Version 5.6.0 - 2020-05-04
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 5.4.0 - 2019-11-04
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 5.2.0 - 2019-05-06
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 5.0.0 - 2018-10-01
+--------------------------
 * Bug fixes (see mercurial logs for details)
 * Remove support for Python 2.7
 
 Version 4.8.0 - 2018-04-23
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 4.6.0 - 2017-10-30
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 4.4.0 - 2017-05-01
+--------------------------
 * Bug fixes (see mercurial logs for details)
 
 Version 4.2.0 - 2016-11-28
+--------------------------
 * Initial release
diff --git a/modules/production_work_timesheet/doc/design.rst b/modules/production_work_timesheet/doc/design.rst
new file mode 100644
index 0000000000..b756e5d077
--- /dev/null
+++ b/modules/production_work_timesheet/doc/design.rst
@@ -0,0 +1,35 @@
+******
+Design
+******
+
+The *Production Work Timesheet Module* introduces or extends the following
+concepts.
+
+.. _model-production.routing.operation:
+
+Routing Operation
+=================
+
+When the *Production Work Timesheet Module* is activated, routings gain a new
+property that defines whether the operation is available for the `Timesheet
+Line <timesheet:model-timesheet.line>`.
+
+.. seealso::
+
+   The `Routing Operation
+   <production_routing:model-production.routing.operation>` concept is
+   introduced by the :doc:`Production Routing Module
+   <production_routing:index>`.
+
+.. _model-production.work:
+
+Production Work
+===============
+
+When the *Production Work Timesheet Module* is activated, works gain a new
+property that records their `Timesheet Lines <timesheet:model-timesheet.line>`.
+
+.. seealso::
+
+   The `Production Work <production_work:model-production.work>` concept
+   is introduced by the :doc:`Production Work Module <production_work:index>`.
diff --git a/modules/production_work_timesheet/doc/index.rst b/modules/production_work_timesheet/doc/index.rst
index 99df023af1..6ab242b73e 100644
--- a/modules/production_work_timesheet/doc/index.rst
+++ b/modules/production_work_timesheet/doc/index.rst
@@ -1,5 +1,12 @@
+################################
 Production Work Timesheet Module
 ################################
 
-The production work timesheet module allows to enter timesheet for production
-works.
+The *Production Work Timesheet Module* records the time employees spend on
+production work.
+
+.. toctree::
+   :maxdepth: 2
+
+   design
+   releases
diff --git a/modules/production_work_timesheet/doc/releases.rst b/modules/production_work_timesheet/doc/releases.rst
new file mode 100644
index 0000000000..21b13c4745
--- /dev/null
+++ b/modules/production_work_timesheet/doc/releases.rst
@@ -0,0 +1,7 @@
+.. _releases-index:
+
+=============
+Release notes
+=============
+
+.. include:: ../CHANGELOG