[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#2066
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:59:25 +00:00
parent 9fbbbc9fcf
commit 250bc3ab21
2050 changed files with 1771 additions and 1770 deletions
@@ -101,7 +101,7 @@ usually the default configuration, but you can check your **Default Sale
Tax** from the menu :menuselection:`Configuration --> Settings`
of the Accounting application.
.. image:: media/price_B2C_B2B01.png
.. image:: B2B_B2C/price_B2C_B2B01.png
:align: center
Once done, you can create a **B2C** pricelist. You can activate the
@@ -118,7 +118,7 @@ included in price) and set a price on this product for B2C customers at
10€, from the :menuselection:`Sales --> Products`
menu of the Sales application:
.. image:: media/price_B2C_B2B02.png
.. image:: B2B_B2C/price_B2C_B2B02.png
:align: center
Setting the B2C fiscal position
@@ -129,7 +129,7 @@ menu: :menuselection:`Configuration --> Fiscal Positions`.
This fiscal position should map the VAT 21% (tax excluded of price)
with a VAT 21% (tax included in price)
.. image:: media/price_B2C_B2B03.png
.. image:: B2B_B2C/price_B2C_B2B03.png
:align: center
Test by creating a quotation
@@ -139,7 +139,7 @@ Create a quotation from the Sale application, using the
:menuselection:`Sales --> Quotations` menu. You should have the
following result: 8.26€ + 1.73€ = 9.99€.
.. image:: media/price_B2C_B2B04.png
.. image:: B2B_B2C/price_B2C_B2B04.png
:align: center
Then, create a quotation but **change the pricelist to B2C and the
@@ -147,7 +147,7 @@ fiscal position to B2C** on the quotation, before adding your product.
You should have the expected result, which is a total price of 10€ for
the customer: 8.26€ + 1.74€ = 10.00€.
.. image:: media/price_B2C_B2B05.png
.. image:: B2B_B2C/price_B2C_B2B05.png
:align: center
This is the expected behavior for a customer of your shop.
@@ -19,7 +19,7 @@ You first have to activate the setting in
:menuselection:`Accounting --> Configuration --> Settings --> Allow Tax Cash Basis`.
You will be asked to define the Tax Cash Basis Journal.
.. image:: media/cash_basis_taxes01.png
.. image:: cash_basis_taxes/cash_basis_taxes01.png
:width: 5.04688in
:height: 0.79688in
:align: center
@@ -29,7 +29,7 @@ Once this is done, you can configure your taxes in
At first set the proper transitional accounts to post taxes
until you register the payment.
.. image:: media/cash_basis_taxes02.png
.. image:: cash_basis_taxes/cash_basis_taxes02.png
:align: center
In the *Advanced Options* tab you will turn *Tax Due* to
@@ -38,7 +38,7 @@ define the *Tax Received* account in which to post the tax amount
when the payment is received and the *Base Tax Received Account*
to post the base tax amount for an accurate tax report.
.. image:: media/cash_basis_taxes03.png
.. image:: cash_basis_taxes/cash_basis_taxes03.png
:align: center
What is the impact of cash basis taxes in my accounting ?
@@ -6,7 +6,7 @@ Default taxes
other indication about which tax to use. For example, Odoo prefills the **Taxes** field with the
Default Taxes when you create a new product or add a new line on an invoice.
.. image:: media/default-taxes-invoice-line.png
.. image:: default_taxes/default-taxes-invoice-line.png
:align: center
:alt: Odoo fills out the Tax field automatically according to the Default Taxes
@@ -26,7 +26,7 @@ To change your **Default Taxes**, go to :menuselection:`Accounting --> Configura
--> Taxes --> Default Taxes`, select the appropriate taxes for your default **Sales Tax** and
**Purchase Tax**, and click on *Save*.
.. image:: media/default-taxes-configuration.png
.. image:: default_taxes/default-taxes-configuration.png
:align: center
:alt: Define which taxes to use by default on Odoo
@@ -9,7 +9,7 @@ according to your customers' and providers' localizations and business types.
**Fiscal Positions** allow you to create *sets of rules* to automatically adapt the taxes and the
accounts used for a transaction.
.. image:: media/fiscal-positions-intra-community.png
.. image:: fiscal_positions/fiscal-positions-intra-community.png
:align: center
:alt: Example: Belgian to Intra-Community tax mapping with Fiscal Positions in Odoo Accounting
@@ -57,7 +57,7 @@ configure a few conditions:
- **VAT Required**: The VAT number *must* be indicated in the customer's contact form.
- **Country Group** / **Country**: The Fiscal Position is applied to these countries.
.. image:: media/fiscal-positions-automatic.png
.. image:: fiscal_positions/fiscal-positions-automatic.png
:align: center
:alt: Example of settings to apply a Fiscal Position automatically
@@ -88,7 +88,7 @@ You can manually define which Fiscal Position must be used by default for a spec
To do so, open the partner's contact form, go to the **Sales & Purchase** tab, edit the **Fiscal
Position** field, and click on *Save*.
.. image:: media/fiscal-positions-partner.png
.. image:: fiscal_positions/fiscal-positions-partner.png
:align: center
:alt: Selection of a Fiscal Position on a Sales Order / Invoice / Bill in Odoo Accounting
@@ -100,7 +100,7 @@ Choose Fiscal Positions manually on Sales Orders, Invoices, and Bills
To manually select which Fiscal Position to use for a new Sales Order, Invoice, or Bill, go to the
**Other Info** tab and select the right **Fiscal Position** *before* adding product lines.
.. image:: media/fiscal-positions-transaction.png
.. image:: fiscal_positions/fiscal-positions-transaction.png
:align: center
:alt: Selection of a Fiscal Position on a Sales Order / Invoice / Bill in Odoo Accounting
@@ -13,7 +13,7 @@ from the amount to pay, as the tax will be paid by the customer.
As, an example, in Colombia you may have the following invoice:
.. image:: media/retention03.png
.. image:: retention/retention03.png
:align: center
In this example, the **company** who sent the invoice owes $20 of taxes to
@@ -26,14 +26,14 @@ In Odoo, a withholding tax is defined by creating a negative tax. For a
retention of 10%, you would configure the following tax (accessible
through :menuselection:`Configuration --> Taxes`):
.. image:: media/retention04.png
.. image:: retention/retention04.png
:align: center
In order to make it appear as a retention on the invoice, you should set
a specific tax group **Retention** on your tax, in the **Advanced Options**
tab.
.. image:: media/retention02.png
.. image:: retention/retention02.png
:align: center
Once the tax is defined, you can use it in your products, sales order or
@@ -51,7 +51,7 @@ Once your tax is created, you can use it on customer forms, sales order
or customer invoices. You can apply several taxes on a single customer
invoice line.
.. image:: media/retention01.png
.. image:: retention/retention01.png
:align: center
.. note::
@@ -62,7 +62,7 @@ invoice line.
The printed invoice will show the different amounts in each tax group.
.. image:: media/retention03.png
.. image:: retention/retention03.png
:align: center
.. seealso::
@@ -17,7 +17,7 @@ In TaxCloud
<https://taxcloud.com/#register>`__ website.
* Register your Odoo website on TaxCloud to get an *API ID* and an *API Key*.
.. image:: media/taxcloud01.png
.. image:: taxcloud/taxcloud01.png
:align: center
* In Settings on TaxCloud, click *Locations* to enter the location of your Office(s) & Warehouse(s).
@@ -30,7 +30,7 @@ In Odoo
* Enter your TaxCloud credentials.
* Click SAVE to store your credentials.
.. image:: media/taxcloud02.png
.. image:: taxcloud/taxcloud02.png
:align: center
* Click the Refresh Icon next to *Default Category* to import the TIC product categories
@@ -101,14 +101,14 @@ You can configure Odoo to automatically detect which Customers should use this f
position. Go to :menuselection:`Accounting --> Configuration --> Fiscal Positions`
to open and edit the record.
.. image:: media/taxcloud03.png
.. image:: taxcloud/taxcloud03.png
:align: center
Now, this fiscal position is automatically set on any sales order, web order, or invoice
when the customer country is *United States*. This triggers the
automated tax computation.
.. image:: media/taxcloud04.png
.. image:: taxcloud/taxcloud04.png
:align: center
Add your product(s). You have two options to get Sales Tax on the Order. You can confirm it,

Before

Width:  |  Height:  |  Size: 6.6 KiB

After

Width:  |  Height:  |  Size: 6.6 KiB

@@ -19,7 +19,7 @@ default, so that you can activate only the ones relevant for your business.
To activate Sale Taxes, go to :menuselection:`Accounting --> Configuration --> Taxes` and use the
*Activate* toggle button to activate or deactivate a tax.
.. image:: media/taxes-list.png
.. image:: taxes/taxes-list.png
:align: center
:alt: Activate pre-configured taxes in Odoo Accounting
@@ -31,7 +31,7 @@ Configuration
To edit or create a **Tax**, go to :menuselection:`Accounting --> Configuration --> Taxes` and open
a tax or click on *Create*.
.. image:: media/taxes-edit.png
.. image:: taxes/taxes-edit.png
:align: center
:alt: Edition of a tax in Odoo Accounting
@@ -156,7 +156,7 @@ Definition tab
Allocate with precision the amount of the taxable basis or percentages of the computed tax to
multiple accounts and Tax Grids.
.. image:: media/taxes-definition.png
.. image:: taxes/taxes-definition.png
:align: center
:alt: Allocate tax amounts to the right accounts and tax grids
@@ -183,7 +183,7 @@ The label of the tax, as displayed on each invoice line in the **Taxes** column.
:ref:`label <taxes/labels>` visible to *front end* users, on exported invoices, on their Customer
Portals, etc.
.. image:: media/taxes-invoice-label.png
.. image:: taxes/taxes-invoice-label.png
:align: center
:alt: The Label on Invoices is displayed on each invoice line
@@ -198,7 +198,7 @@ Select to which **Tax Group** the tax belongs. The Tax Group name is the :ref:`l
Tax groups include different iterations of the same tax. This can be useful when you must record
differently the same tax according to :doc:`Fiscal Positions <fiscal_positions>`.
.. image:: media/taxes-invoice-tax-group.png
.. image:: taxes/taxes-invoice-tax-group.png
:align: center
:alt: The Tax Group name is different from the Label on Invoices
@@ -258,7 +258,7 @@ the same product.
You can configure a new :ref:`Group of Taxes <taxes/computation>` to include this tax, or add it
directly to a product line.
.. image:: media/taxes-subsequent-line.png
.. image:: taxes/taxes-subsequent-line.png
:align: center
:alt: The eco-tax is taken into the basis of the 21% VAT tax
@@ -270,7 +270,7 @@ directly to a product line.
To reorder the sequence, go to :menuselection:`Accounting --> Configuration --> Taxes`, and drag
and drop the lines with the handles next to the tax names.
.. image:: media/taxes-list-sequence.png
.. image:: taxes/taxes-list-sequence.png
:align: center
:alt: The taxes' sequence in Odoo determines which tax is applied first

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

Before

Width:  |  Height:  |  Size: 7.3 KiB

After

Width:  |  Height:  |  Size: 7.3 KiB

@@ -15,7 +15,7 @@ Configuration
To enable this feature, go to :menuselection:`Accounting --> Configuration --> Settings --> Taxes`,
enable the **Verify VAT Numbers** feature, and click on *Save*.
.. image:: media/vat-validation-configuration.png
.. image:: vat_validation/vat-validation-configuration.png
:align: center
:alt: Enable "Verify VAT Numbers" in Odoo Accounting
@@ -24,14 +24,14 @@ VAT Number validation
Whenever you create or modify a contact, make sure to fill out the **Country** and **VAT** fields.
.. image:: media/vat-validation-contact-form.png
.. image:: vat_validation/vat-validation-contact-form.png
:align: center
:alt: Fill out the contact form with the country and VAT number before clicking on *Save*
When you click on *Save*, Odoo runs a VIES VAT number check, and displays an error message if the
VAT number is invalid.
.. image:: media/vat-validation-error.png
.. image:: vat_validation/vat-validation-error.png
:align: center
:alt: Odoo displays an error message instead of saving when the VAT number is invalid