[MOV] content/*: move resource files into their related page's directory

Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2068
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:54:32 +00:00
parent 3901e3b241
commit 8722ea902e
2056 changed files with 1777 additions and 1776 deletions
@@ -21,7 +21,7 @@ Configure your Work Centers
First, go to the :menuselection:`Manufacturing app --> Configuration --> Settings`. Then, enable
the Work Orders feature and hit save.
.. image:: media/bom_3.png
.. image:: bill_configuration/bom_3.png
:align: center
:alt: work order settings ticked
@@ -31,7 +31,7 @@ two new work centers. Add the second work center as an alternative to
the first one and vice versa.
.. image:: media/wc_alternate1.png
.. image:: alternative_wc/wc_alternate1.png
:align: center
@@ -39,7 +39,7 @@ Next, go to :menuselection:`Products --> Bills of Materials`, choose your produc
and add these work centers to the operations of your BOM.
.. image:: media/wc_alternate2.png
.. image:: alternative_wc/wc_alternate2.png
:align: center
@@ -56,7 +56,7 @@ Each new *Work Order*, which will be created before the end of the
first one, will be scheduled at the alternative work center you
configured, as shown below.
.. image:: media/wc_alternate3.png
.. image:: alternative_wc/wc_alternate3.png
:align: center
@@ -30,7 +30,7 @@ respective quantities. You can create components as you go, on the BOM, or creat
by going to the :menuselection:`Top Menu --> Products --> Create`, and add them later on.
.. image:: media/bom_1.png
.. image:: bill_configuration/bom_1.png
:align: center
.. warning::
@@ -49,7 +49,7 @@ in the dedicated field below the product name. Or use one BOM, that contains
all of the components and for each component, indicate which variant it applies to,
using the *Apply on Variants* column, as shown below.
.. image:: media/bom_2.png
.. image:: bill_configuration/bom_2.png
:align: center
@@ -60,7 +60,7 @@ You can also add operations to your *BoM*, if you want workers to follow instruc
or register time spent. To use this feature, enable the *Work Orders* feature in the
*Manufacturing* app settings, as shown below.
.. image:: media/bom_3.png
.. image:: bill_configuration/bom_3.png
:align: center
.. note::
@@ -68,12 +68,12 @@ or register time spent. To use this feature, enable the *Work Orders* feature in
Operations Operations can be re-used when configuring a new BOM, with the *Copy Existing
Operations* feature.
.. image:: media/bom_4.png
.. image:: bill_configuration/bom_4.png
:align: center
Finally, just like for components, operations can also be variant specific only, as shown below.
.. image:: media/bom_5.png
.. image:: bill_configuration/bom_5.png
:align: center
@@ -87,7 +87,7 @@ of a *BoM*. As opposed to the primary product, there can be more than one on a B
To add *by-products* to a *BoM*, you will first need to enable the by-product
feature from the *Manufacturing* app settings.
.. image:: media/bom_6.png
.. image:: bill_configuration/bom_6.png
:align: center
Once the feature is enabled, you can add *by-products* to your
@@ -17,10 +17,10 @@ but will generate a delivery order with one line item for each of the components
the examples below, the first image shows a sales order for the kit *Custom Computer Kit*,
while the second image shows the corresponding delivery order.
.. image:: media/kit-so-line.png
.. image:: kit_shipping/kit-so-line.png
:align: center
.. image:: media/kit-do-picking.png
.. image:: kit_shipping/kit-do-picking.png
:align: center
Configuration
@@ -41,7 +41,7 @@ products require no particular configuration.
Once the products are configured, create a *bill of materials* for the kit product. Add each component
and its quantity. Select the *BoM Type* Kit. All other options may be left with their default values.
.. image:: media/kit-bom.png
.. image:: kit_shipping/kit-bom.png
:align: center
Manage Stock of Kit Product and Component Products
@@ -54,7 +54,7 @@ subcontractor, or make it yourself through a manufacturing order.
In that case the product type will be storable, and the BOM type either 'Manufacture this product'
or 'Subcontracting' as shown below.
.. image:: media/kit-storable.png
.. image:: kit_shipping/kit-storable.png
:align: center
@@ -67,20 +67,20 @@ Imagine the Custom Computer parts above were part of another final product. It w
clearer and simpler if the BOMs were added together (as shown below) instead of adding all
the individual parts one by one.
.. image:: media/kit-bom4.png
.. image:: kit_shipping/kit-bom4.png
:align: center
This is even better illustrated when looking at the BOM Structure Report, where it is
easy to expand and hide specific kit level or sub-assembly type BOMs.
.. image:: media/kit-bom5.png
.. image:: kit_shipping/kit-bom5.png
:align: center
On the creation of the manufacturing order, the BOM will automatically expand to show all
top level and kit level components. You can go back to the BOM at any point though as it
remains available on the form view of your manufacturing order.
.. image:: media/kit-bom6.png
.. image:: kit_shipping/kit-bom6.png
:align: center
Finally, note that if there were any Operations in the Kit BOM, these would also simply be added
Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.3 KiB

@@ -6,7 +6,7 @@ Odoo allows you to use one bill of materials for multiple variants of
the same product. To activate variants, simply go to :menuselection:`Configuration --> Settings
--> Variants`.
.. image:: media/bom-variants1.png
.. image:: product_variants/bom-variants1.png
:align: center
You will then be able to specify which BOM component lines are to be used in
@@ -20,16 +20,16 @@ below. This field is used when creating a BoM for one specific variant
of a product only.
.. image:: media/kit-bom1.png
.. image:: product_variants/kit-bom1.png
:align: center
Note that the same principle applies for the configuration
of operations.
.. image:: media/kit-bom2.png
.. image:: product_variants/kit-bom2.png
:align: center
And for the production of by-products.
.. image:: media/kit-bom3.png
.. image:: product_variants/kit-bom3.png
:align: center
@@ -13,13 +13,13 @@ on the Manufacturing Operation Type, as shown below. To create it, Go to :menuse
If the check only applies to specific products, or product categories, you can specify these during
the setup as well.
.. image:: media/qc_1.png
.. image:: quality_control/qc_1.png
:align: center
Regarding the reception of subcontracted products, instead of the Manufacturing Operation Type,
you need to select the 'Receipts' Operation type. For the rest, the same principles apply.
.. image:: media/qc_2.png
.. image:: quality_control/qc_2.png
:align: center
By doing so, a quality check is automatically created each time a
@@ -19,7 +19,7 @@ and its sub-assemblies. Therefore, you must first create the sub-assembly
products and their respective Bill of Materials. Please refer to
:doc:`bill_configuration` for more details on how to create a BOM.
.. image:: media/sf_1.png
.. image:: sub_assemblies/sf_1.png
:align: center
Configure the Main BoM
@@ -28,7 +28,7 @@ Configure the Main BoM
Then on the final product form, simply add your semi-finished
products to the Bill of Material.
.. image:: media/sf_2.png
.. image:: sub_assemblies/sf_2.png
:align: center
Manage your production planning
@@ -42,7 +42,7 @@ the semi-finished products as well, you have two options:
Option 1 : Create re-ordering rules for the semi-finished products, with both the minimum
and maximum desired stock quantities at 0.
.. image:: media/sf_3.png
.. image:: sub_assemblies/sf_3.png
:align: center
Option 2 : Use the Replenish on Order (MTO) route on the semi-finished product, as well as
@@ -56,5 +56,5 @@ production and redirect it to another, more pressing demand, for example.
In any case, as soon as the semi-finished product is produced, it will become
available in the manufacturing order of the final product, as shown below.
.. image:: media/sf_4.png
.. image:: sub_assemblies/sf_4.png
:align: center
@@ -13,7 +13,7 @@ is not easy. To make it work correctly, you have to:
Here is an example of subcontracting the manufacturing of “C”, which is
produced out of raw materials “A” and “B”.
.. image:: media/subcontracting_01.png
.. image:: subcontracting/subcontracting_01.png
:align: center
:alt:
@@ -25,7 +25,7 @@ Configuration
To use the subcontracting feature, go to :menuselection:`Manufacturing
--> Configuration --> Settings` and tick the box *Subcontracting*.
.. image:: media/sbc_1.png
.. image:: subcontracting/sbc_1.png
:align: center
:alt:
@@ -41,7 +41,7 @@ that are sourced directly from the subcontractor.
Once you have set the *BoM Type* to *Subcontracting*, specify one or
several subcontractors.
.. image:: media/sbc_2.png
.. image:: subcontracting/sbc_2.png
:align: center
:alt:
@@ -53,7 +53,7 @@ send them purchase orders (PO). To do so, go to the *Purchase* app and
create a new purchase order. Be sure to send the PO to a vendor that is
defined as a subcontractor on the *BoM* of these products.
.. image:: media/subcontracting_04.png
.. image:: subcontracting/subcontracting_04.png
:align: center
:alt:
@@ -122,14 +122,14 @@ button appears. Click on it to open a dialog box and record the serial/lot numbe
the components. If the finished product is also tracked, its serial/lot number can
be registered here too.
.. image:: media/sbc_3.png
.. image:: subcontracting/sbc_3.png
:align: center
:alt:
For audit purposes, it is possible to check the lot numbers recorded on
a receipt by using the icon on the right of the finished products:
.. image:: media/sbc_4.png
.. image:: subcontracting/sbc_4.png
:align: center
:alt:
@@ -138,7 +138,7 @@ BOM for a non-tracked product, the record components option will also appear
optionally on each move line, if you want to register more or less component consumption
at your subcontracting location, when receiving your final product.
.. image:: media/sbc_5.png
.. image:: subcontracting/sbc_5.png
:align: center
:alt:
@@ -161,7 +161,7 @@ below. If this is a component that you buy from a vendor, the buy route
should also be activated.
.. image:: media/sbc_6.png
.. image:: subcontracting/sbc_6.png
:align: center
:alt:
@@ -175,7 +175,7 @@ Once the PO to the subcontractor is validated, this route will create a dropship
RFQ from your vendor to that subcontractor. You then just need to review and validate it.
.. image:: media/sbc_7.png
.. image:: subcontracting/sbc_7.png
:align: center
:alt:
@@ -188,7 +188,7 @@ Configuration --> Settings --> Storage locations`.
From the location form, you are then able to access the Current Stock.
.. image:: media/sbc_8.png
.. image:: subcontracting/sbc_8.png
:align: center
:alt:
@@ -203,12 +203,12 @@ If you want to send components to your subcontractor at your own convenience,
select the 'Resupply Subcontractor' Operation Type from the *Inventory* Module,
and create a picking, specifying to which subcontractor you are delivering to.
.. image:: media/sbc_9.png
.. image:: subcontracting/sbc_9.png
:align: center
:alt:
Alternatively, you can also manually ask your vendor to resupply your subcontractor
by creating a dropship type PO, with your subcontractor set as the delivery address.
.. image:: media/sbc_10.png
.. image:: subcontracting/sbc_10.png
:align: center
@@ -20,7 +20,7 @@ product*. You can now define your safety stock target (= the stock you
want to have on hand at the end of the period) and the minimum and
maximum quantities that must or can be replenished in each period.
.. image:: media/mps_1.png
.. image:: use_mps/mps_1.png
:align: center
In the MPS view, you can decide which information you would like to display
@@ -29,7 +29,7 @@ quantity of products has already been ordered for the period, or *Available to P
what can still be sold during that same period (what you plan to replenish - what
is already sold during the period). You can also decide to hide rows if you like.
.. image:: media/mps_2.png
.. image:: use_mps/mps_2.png
:align: center
Estimate your demand and launch replenishment
@@ -40,7 +40,7 @@ in the *Forecasted Demand* Row. You can easily, at any time, compare the demand
forecast with the actual demand (= confirmed sales). The demand forecast for a
finished product will impact the indirect demand for its components.
.. image:: media/mps_3.png
.. image:: use_mps/mps_3.png
:align: center
Once the forecasted demand has been set, the quantity to replenish for the
@@ -53,7 +53,7 @@ Depending on the configuration of the product (buy vs. manufacture),
requests for quotations or manufacturing orders will be created. You can
easily access those by clicking on the *Actual Replenishment* cell.
.. image:: media/mps_4.png
.. image:: use_mps/mps_4.png
:align: center
In case you manually edit the *Suggested Replenishment* quantity, a small cross