[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
@@ -40,7 +40,7 @@ Configure an Assets Account
To configure your account in the **Chart of Accounts**, go to :menuselection:`Accounting -->
Configuration --> Chart of Accounts`, click on *Create*, and fill out the form.
.. image:: media/assets01.png
.. image:: assets/assets01.png
:align: center
:alt: Configuration of an Assets Account in Odoo Accounting
@@ -55,7 +55,7 @@ Select the account on a draft bill
On a draft bill, select the right account for all the assets you are buying.
.. image:: media/assets02.png
.. image:: assets/assets02.png
:align: center
:alt: Selection of an Assets Account on a draft bill in Odoo Accounting
@@ -67,7 +67,7 @@ Choose a different Expense Account for specific products
Start editing the product, go to the *Accounting* tab, select the right **Expense Account**, and
save.
.. image:: media/assets03.png
.. image:: assets/assets03.png
:align: center
:alt: Change of the Assets Account for a product in Odoo
@@ -84,7 +84,7 @@ To do so, open your Purchases Journal by going to :menuselection:`Accounting -->
Purchases`, select the journal item you want to modify, click on the account, and select the right
one.
.. image:: media/assets04.png
.. image:: assets/assets04.png
:align: center
:alt: Modification of a posted journal item's account in Odoo Accounting
@@ -106,7 +106,7 @@ Click on **select related purchases** to link an existing journal item to this n
fields are then automatically filled out, and the journal item is now listed under the **Related
Purchase** tab.
.. image:: media/assets05.png
.. image:: assets/assets05.png
:align: center
:alt: Assets entry in Odoo Accounting
@@ -114,7 +114,7 @@ Once done, you can click on *Compute Depreciation* (next to the *Confirm* button
the values of the **Depreciation Board**. This board shows you all the entries that Odoo will post
to depreciate your asset, and at which date.
.. image:: media/assets06.png
.. image:: assets/assets06.png
:align: center
:alt: Depreciation Board in Odoo Accounting
@@ -157,7 +157,7 @@ in the right account (see: :ref:`journal-assets-account`).
Then, click on *Action*, select **Create Asset**, and fill out the form the same way you would do to
:ref:`create a new entry <create-assets-entry>`.
.. image:: media/assets07.png
.. image:: assets/assets07.png
:align: center
:alt: Create Asset Entry from a journal item in Odoo Accounting
@@ -176,7 +176,7 @@ An **increase in value** requires you to fill out additional fields related to t
and creates a new Asset entry with the **Value Increase**. The Gross Increase Asset Entry can be
accessed with a Smart Button.
.. image:: media/assets08.png
.. image:: assets/assets08.png
:align: center
:alt: Gross Increase smart button in Odoo Accounting
@@ -187,7 +187,7 @@ To **sell** an asset or **dispose** of it implies that it must be removed from t
To do so, open the asset you want to dispose of, click on *Sell or Dispose*, and fill out the form.
.. image:: media/assets09.png
.. image:: assets/assets09.png
:align: center
:alt: Disposal of Assets in Odoo Accounting
@@ -222,7 +222,7 @@ account.
New buttons with all the models linked to that account appear at the top of the form. Clicking on a
model button fills out the form according to that model.
.. image:: media/assets10.png
.. image:: assets/assets10.png
:align: center
:alt: Assets model button in Odoo Accounting
@@ -244,7 +244,7 @@ You have three choices for the **Automate Assets** field:
#. **Create and validate:** you must also select an Asset Model (see: `Assets Models`_). Whenever a
transaction is posted on the account, an *Assets entry* is created and immediately validated.
.. image:: media/assets11.png
.. image:: assets/assets11.png
:align: center
:alt: Automate Assets on an account in Odoo Accounting
@@ -37,7 +37,7 @@ Configure a Deferred Expense Account
To configure your account in the **Chart of Accounts**, go to :menuselection:`Accounting -->
Configuration --> Chart of Accounts`, click on *Create*, and fill out the form.
.. image:: media/deferred_expenses01.png
.. image:: deferred_expenses/deferred_expenses01.png
:align: center
:alt: Configuration of a Deferred Expense Account in Odoo Accounting
@@ -53,7 +53,7 @@ Select the account on a draft bill
On a draft bill, select the right account for all the products of which the expenses must be
deferred.
.. image:: media/deferred_expenses02.png
.. image:: deferred_expenses/deferred_expenses02.png
:align: center
:alt: Selection of a Deferred Expense Account on a draft bill in Odoo Accounting
@@ -63,7 +63,7 @@ Choose a different Expense Account for specific products
Start editing the product, go to the *Accounting* tab, select the right **Expense Account**, and
save.
.. image:: media/deferred_expenses03.png
.. image:: deferred_expenses/deferred_expenses03.png
:align: center
:alt: Change of the Expense Account for a product in Odoo
@@ -78,7 +78,7 @@ To do so, open your Purchases Journal by going to :menuselection:`Accounting -->
Purchases`, select the journal item you want to modify, click on the account, and select the right
one.
.. image:: media/deferred_expenses04.png
.. image:: deferred_expenses/deferred_expenses04.png
:align: center
:alt: Modification of a posted journal item's account in Odoo Accounting
@@ -98,7 +98,7 @@ Click on **select related purchases** to link an existing journal item to this n
fields are then automatically filled out, and the journal item is now listed under the **Related
Expenses** tab.
.. image:: media/deferred_expenses05.png
.. image:: deferred_expenses/deferred_expenses05.png
:align: center
:alt: Deferred Expense entry in Odoo Accounting
@@ -106,7 +106,7 @@ Once done, you can click on *Compute Deferral* (next to the *Confirm* button) to
values of the **Expense Board**. This board shows you all the entries that Odoo will post to
recognize your expense, and at which date.
.. image:: media/deferred_expenses06.png
.. image:: deferred_expenses/deferred_expenses06.png
:align: center
:alt: Expense Board in Odoo Accounting
@@ -134,7 +134,7 @@ account (see: `Change the account of a posted journal item`_).
Then, click on *Action*, select **Create Deferred Entry**, and fill out the form the same way you
would do to `create a new entry`_.
.. image:: media/deferred_expenses07.png
.. image:: deferred_expenses/deferred_expenses07.png
:align: center
:alt: Create Deferred Entry from a journal item in Odoo Accounting
@@ -160,7 +160,7 @@ right recognition account.
New buttons with all the models linked to that account appear at the top of the form. Clicking on a
model button fills out the form according to that model.
.. image:: media/deferred_expenses08.png
.. image:: deferred_expenses/deferred_expenses08.png
:align: center
:alt: Deferred Expense model button in Odoo Accounting
@@ -182,7 +182,7 @@ You have three choices for the **Automate Deferred Expense** field:
Models`_). Whenever a transaction is posted on the account, a *Deferred Expenses entry* is
created and immediately validated.
.. image:: media/deferred_expenses09.png
.. image:: deferred_expenses/deferred_expenses09.png
:align: center
:alt: Automate Deferred Expense on an account in Odoo Accounting
@@ -44,7 +44,7 @@ Creating products in Odoo is essential for quick and efficient
purchasing within Odoo. Simply navigate to the Products submenu under
Purchase and click create.
.. image:: ./media/manage01.png
.. image:: manage/manage01.png
:align: center
When creating the product, pay attention to the **Product Type** field,
@@ -78,7 +78,7 @@ quotation for an order, you may record the order reference number in the
with the the vendor bill later (as the vendor bill will probably include
the Vendor Reference)
.. image:: ./media/manage02.png
.. image:: manage/manage02.png
:align: center
Validate the purchase order and receive the products from the Inventory
@@ -93,13 +93,13 @@ after you confirm a purchase order. From the **Inventory dashboard**, you
should see a button linking you directly to the transfer of products.
This button is outlined in red below:
.. image:: ./media/manage03.png
.. image:: manage/manage03.png
:align: center
Navigating this route will take you to a list of all orders waiting to
be received.
.. image:: ./media/manage04.png
.. image:: manage/manage04.png
:align: center
If you have a lot of awaiting orders, apply a filter using the search
@@ -110,7 +110,7 @@ group the orders by different criteria under **Group By**. Selecting an
item from this list will open the following screen where you then will
receive the products.
.. image:: ./media/manage05.png
.. image:: manage/manage05.png
:align: center
Purchasing service products does not trigger a delivery order.
@@ -123,7 +123,7 @@ record it in the Purchases application under the **Control Menu**. You
need to create a new vendor bill even if you already registered a
purchase order.
.. image:: ./media/manage06.png
.. image:: manage/manage06.png
:align: center
The first thing you will need to do upon creating a vendor bill is to
@@ -137,7 +137,7 @@ the appropriate vendor bill, you may search through the list by
inputting the vendor reference number or your internal purchase order
number.
.. image:: ./media/manage07.png
.. image:: manage/manage07.png
:align: center
While the invoice is in a draft state, you can make any modifications you
@@ -207,7 +207,7 @@ Ask your system administrator to enable these access on :menuselection:`Settings
select the product(s) you wish to modify, and you should see a new field appear,
labeled **Control Purchase Bills**.
.. image:: ./media/manage08.png
.. image:: manage/manage08.png
:align: center
You can then change the default management method for the selected
@@ -14,7 +14,7 @@ Set up the feature
Go to :menuselection:`Accounting --> Settings --> Bill Digitalization`, and choose whether the bills
should be processed automatically (with OCR) or manually (on demand).
.. image:: media/setup_ocr.png
.. image:: ocr/setup_ocr.png
:align: center
:alt: Activate the feature going to the settings application in Odoo Accounting
@@ -32,7 +32,7 @@ need to click on *Send for Digitalization* to do it manually.
Once the data is extracted from the PDF, you can correct it if necessary by clicking on the
respective tag (available in *Edit* mode), and selecting the right information instead.
.. image:: media/example_ocr.png
.. image:: ocr/example_ocr.png
:align: center
:height: 580
:alt: Example of a scanned bill in Odoo Accounting
@@ -20,7 +20,7 @@ Register a receipt
To record a new receipt, go to :menuselection:`Accounting --> Vendors --> Receipts`, click on
*Create*, fill out the form, and click on *Post*.
.. image:: media/purchase_receipts_draft.png
.. image:: purchase_receipts/purchase_receipts_draft.png
:align: center
:alt: Fill out the draft purchase receipt in Odoo Accounting
@@ -36,7 +36,7 @@ post it.
To do so, click on the **Journal Items** tab, change the accounts and values according to your
needs, and click on *Post*.
.. image:: media/purchase_receipts_journal_items.png
.. image:: purchase_receipts/purchase_receipts_journal_items.png
:align: center
:alt: Change the accounts used in the journal entry to record a purchase receipt.