[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#2064
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:58:14 +00:00
parent fbb1cfc90f
commit 17df8c547a
2048 changed files with 1770 additions and 1769 deletions
@@ -6,7 +6,7 @@ To process an inventory adjustment by using barcodes, you first need to
open the *Barcode* app. Then, from the application, click on
*Inventory Adjustments*.
.. image:: media/adjustments_01.png
.. image:: adjustments/adjustments_01.png
:align: center
.. note::
@@ -18,13 +18,13 @@ automatically create one. Note that, if you work with multi-location,
you first need to specify in which location the inventory adjustment
takes place.
.. image:: media/adjustments_02.png
.. image:: adjustments/adjustments_02.png
:align: center
If you dont work with multi-location, you will be able to scan the
different products you want to include in the inventory adjustment.
.. image:: media/adjustments_03.png
.. image:: adjustments/adjustments_03.png
:align: center
.. note::
@@ -35,14 +35,14 @@ Besides using the barcode scanner, you can also manually add a product
if necessary. To do so, click on *Add Product* and fill the
information in manually.
.. image:: media/adjustments_04.png
.. image:: adjustments/adjustments_04.png
:align: center
.. image:: media/adjustments_05.png
.. image:: adjustments/adjustments_05.png
:align: center
When you have scanned all the items of the location, validate the
inventory manually or scan the *Validate* barcode.
.. image:: media/adjustments_06.png
.. image:: adjustments/adjustments_06.png
:align: center
@@ -20,14 +20,14 @@ To do so, go to :menuselection:`Inventory --> Configuration --> Barcode Nomencla
You can create a barcode nomenclature from there, and then add a line to
create your first rule.
.. image:: media/barcode_nomenclature_01.png
.. image:: barcode_nomenclature/barcode_nomenclature_01.png
:align: center
The first step is to specify the **rule name**, for example Weight
Barcode with 3 Decimals. You then have to specify the type for barcode
nomenclature, in our case it will be Weighted Product.
.. image:: media/barcode_nomenclature_02.png
.. image:: barcode_nomenclature/barcode_nomenclature_02.png
:align: center
The Barcode Pattern is a regular expression that defines the structure
@@ -53,7 +53,7 @@ Configure your Product
3. The barcode should contain 0s where you did defined Ds or Ns. In our case we need to set 5 zeros because we configured “21…..{NNDDD}”;
4. In EAN-13, the last number is a check number, use an EAN13 generator to know which digit it should be in your case.
.. image:: media/barcode_nomenclature_03.png
.. image:: barcode_nomenclature/barcode_nomenclature_03.png
:align: center
In case you weight 1,5 Kg of pasta, the balance will print you the
@@ -63,7 +63,7 @@ automatically create a new line for the Pasta product for a quantity of
1.5 Kg. For the point of sale, a price depending on the quantity will
also be computed.
.. image:: media/barcode_nomenclature_04.png
.. image:: barcode_nomenclature/barcode_nomenclature_04.png
:align: center
Rule Types
@@ -8,17 +8,17 @@ Simple Transfers
To process a transfer from the *Barcode* app, the first step is to go
to *Operations*.
.. image:: media/internal_01.png
.. image:: internal/internal_01.png
:align: center
Then, you have the choice to either enter an existing transfer, by going
to the corresponding operation type and manually selecting the one you
want to enter, or by scanning the barcode of the transfer.
.. image:: media/internal_02.png
.. image:: internal/internal_02.png
:align: center
.. image:: media/internal_03.png
.. image:: internal/internal_03.png
:align: center
From there, you will be able to scan the products that are part of the
@@ -26,7 +26,7 @@ existing transfer and/or add new products to this transfer. Once all the
products have been scanned, you can validate the transfer to proceed
with the stock moves.
.. image:: media/internal_04.png
.. image:: internal/internal_04.png
:align: center
.. note::
@@ -41,7 +41,7 @@ to identify it in the system. Once done, you can either make it enter
the main location of the transfer, for example WH/Stock, or scan a
location barcode to make it enter a sub-location of the main location.
.. image:: media/internal_05.png
.. image:: internal/internal_05.png
:align: center
.. note::
@@ -56,7 +56,7 @@ different than the one initially set on the transfer. Then, you can
start scanning the products that are delivered from this specific
location.
.. image:: media/internal_06.png
.. image:: internal/internal_06.png
:align: center
Once the different products have been scanned, you have the possibility
@@ -64,14 +64,14 @@ to scan another location, such as WH/Stock, and another page will be
added to your delivery order. You can move from one to the other thanks
to the *Previous* and *Next* buttons.
.. image:: media/internal_07.png
.. image:: internal/internal_07.png
:align: center
Now, you can validate your transfer. To do so, click on *Next* until
you reach the last page of the transfer. There, you will be able to
validate it.
.. image:: media/internal_08.png
.. image:: internal/internal_08.png
:align: center
Internal Transfers
@@ -93,10 +93,10 @@ ways of working:
- If you work with serial/lot numbers taking all products into consideration, you can scan the barcode of the lot/serial number and Odoo will increase the quantity of the product, setting its lot/serial number.
.. image:: media/internal_09.png
.. image:: internal/internal_09.png
:align: center
- If you have the same lot/serial number for different products, you can work by scanning the product barcode first, and then the barcode of the lot/serial number.
.. image:: media/internal_10.png
.. image:: internal/internal_10.png
:align: center
@@ -6,12 +6,12 @@ To create a transfer from the *Barcode* application, you first need to
print the operation type barcodes. To do so, you can download the
*Stock barcode sheet* from the home page of the app.
.. image:: media/transfers_scratch_01.png
.. image:: transfers_scratch/transfers_scratch_01.png
:align: center
Once done, you can scan the one for which you want to create a new
document. Then, an empty document will be created and you will be able
to scan your products to populate it.
.. image:: media/transfers_scratch_02.png
.. image:: transfers_scratch/transfers_scratch_02.png
:align: center
@@ -14,7 +14,7 @@ The 3 recommended type of barcode scanners to work with the Odoo
**Inventory** and **Barcode Scanning** apps are the **USB scanner**, **the bluetooth
scanner** and the **mobile computer scanner**.
.. image:: media/hardware02.png
.. image:: hardware/hardware02.png
:align: center
- If you scan products at a computer location, the **USB scanner** is the
@@ -44,7 +44,7 @@ Configure your barcode scanner
Keyboard layout
---------------
.. image:: media/hardware01.png
.. image:: hardware/hardware01.png
:align: center
An USB barcode scanner needs to be configured to use the same keyboard
@@ -15,7 +15,7 @@ To use this feature, you first need to activate the *Barcode*
functionality via :menuselection:`Inventory --> Settings --> Barcode Scanner`. Once you
have ticked the feature, you can hit save.
.. image:: media/software_01.png
.. image:: software/software_01.png
:align: center
Set Product Barcodes
@@ -24,16 +24,16 @@ Set Product Barcodes
You can easily assign barcodes to your different products via the
*Inventory* app. To do so, go to :menuselection:`Settings --> Configure Products Barcodes`.
.. image:: media/software_02.png
.. image:: software/software_02.png
:align: center
Then, you have the possibility to assign barcodes to your products
directly at creation on the product form.
.. image:: media/software_03.png
.. image:: software/software_03.png
:align: center
.. image:: media/software_04.png
.. image:: software/software_04.png
:align: center
.. note::
@@ -48,10 +48,10 @@ If you manage multiple locations, you will find useful to attribute a
barcode to each location and stick it on the location. You can configure
the locations barcodes in :menuselection:`Inventory --> Configuration --> Locations`.
.. image:: media/software_05.png
.. image:: software/software_05.png
:align: center
.. image:: media/software_06.png
.. image:: software/software_06.png
:align: center
.. note::