Update documentation of production routing

modules/production_routing/CHANGELOG

@@ -38,45 +38,58 @@ 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
+--------------------------
 * Bug fixes (see mercurial logs for details)
 * Add routing as Lead Time parameter
 
 Version 4.0.0 - 2016-05-02
+--------------------------
 * Initial release

modules/production_routing/doc/design.rst

@@ -0,0 +1,71 @@
+******
+Design
+******
+
+The *Production Routing Module* introduces or extends the following concepts.
+
+.. _model-production.routing:
+
+Routing
+=======
+
+A *Routing* specifies the operational steps involved in a `Production
+<production:model-production>` process and the order in which in they occur.
+Routings can be linked to multiple `Bill of Materials
+<production:model-production.bom>`.
+
+.. seealso::
+
+   The Routings can be found using the main menu item:
+
+      |Productions --> Configuration --> Routings|__
+
+      .. |Productions --> Configuration --> Routings| replace:: :menuselection:`Productions --> Configuration --> Routings`
+      __ https://demo.tryton.org/model/production.routing
+
+.. _model-production.routing.operation:
+
+Operation
+=========
+
+An *Operation* is a general production activity.
+
+.. seealso::
+
+   The *Operations* can be found using the main menu item:
+
+      |Productions --> Configuration --> Routings --> Operations|__
+
+      .. |Productions --> Configuration --> Routings --> Operations| replace:: :menuselection:`Productions --> Configuration --> Routings --> Operations`
+      __ https://demo.tryton.org/model/production.routing
+
+.. _concept-product:
+
+Product
+=======
+
+When the *Production Routing Module* is activated, products gain some extra
+properties.
+A `Routing <model-production.routing>` can be specified for each `BOMs
+<production:model-production.bom>` listed.
+A production lead times can also be defined per `Routing
+<model-production.routing>`.
+
+.. seealso::
+
+   The `Product <production:concept-product>` concept is extended from the
+   :doc:`Production Module <production:index>`.
+
+.. _model-production:
+
+Production
+==========
+
+When the *Production Routing Module* is activated, productions gain some extra
+properties such as the `Routing <model-production.routing>` which is used to
+adapt the lead time.
+
+.. seealso::
+
+   The `Production <production:model-production>` concept is introduced by the
+   :doc:`Production Module <production:index>`.

modules/production_routing/doc/index.rst

@@ -1,21 +1,12 @@
+#########################
 Production Routing Module
 #########################
 
-The production routing module defines the routings for production: Routing,
-Step and Operation.
+The *Production Routing Module* provides the fundamental concept for
+managing operations on productions.
 
-Routing
-*******
+.. toctree::
+   :maxdepth: 2
 
-Routings are a list of steps to follow with one of the BOMs to produce a
-product.
-
-Step
-****
-
-Steps define the operation to perform at a specific point of the routing.
-
-Operation
-*********
-
-An operation is a generic action.
+   design
+   releases

modules/production_routing/doc/releases.rst

@@ -0,0 +1,7 @@
+.. _releases-index:
+
+=============
+Release notes
+=============
+
+.. include:: ../CHANGELOG