[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
@@ -18,7 +18,7 @@ Configuration --> Management --> Payment Terms` and click on
during which the offer is valid. You can also change the default balance
term if needed.
.. image:: media/cash_discounts01.png
.. image:: cash_discounts/cash_discounts01.png
:align: center
Start offering the cash discount
@@ -30,7 +30,7 @@ automatically split the account receivables part of the journal entry
into two installments having different due dates. Since the discounted
price is already calculated, your payment controls will be simplified.
.. image:: media/cash_discounts02.png
.. image:: cash_discounts/cash_discounts02.png
:align: center
Grant the cash discount
@@ -41,7 +41,7 @@ cash discount. When you process the bank statement, match the payment
with the related journal entry. Then, select the remaining cash discount
and click on *Create Write-off* to reconcile it.
.. image:: media/cash_discounts03.png
.. image:: cash_discounts/cash_discounts03.png
:align: center
.. tip::
@@ -59,7 +59,7 @@ In this case, the customer has not fulfilled the payment term and cannot
benefit from the cash discount. When you process the bank statement,
match the payment with the two related journal entries.
.. image:: media/cash_discounts04.png
.. image:: cash_discounts/cash_discounts04.png
:align: center
@@ -16,7 +16,7 @@ Configuration
Go to :menuselection:`Accounting --> Configuration --> Settings`
and enable *Cash Rounding*, then click on *Save*.
.. image:: media/cash_rounding01.png
.. image:: cash_rounding/cash_rounding01.png
:align: center
Go to :menuselection:`Accounting --> Configuration --> Cash Roundings`,
@@ -28,7 +28,7 @@ from the invoices they are related to.
To do so, open the *Customer Invoice*, and click on *Add Credit Note*.
.. image:: media/credit_notes01.png
.. image:: credit_notes/credit_notes01.png
:align: center
You can choose between three options:
@@ -56,7 +56,7 @@ Full Refund
Odoo creates a credit note, automatically validates it, and
reconciles the original invoice with it.
.. image:: media/credit_notes02.png
.. image:: credit_notes/credit_notes02.png
:align: center
This is the option to choose to do a full refund or cancel
@@ -86,11 +86,11 @@ that zeroes out the journal items generated by the original invoice.
Here is an example of an invoices journal entry:
.. image:: media/credit_notes03.png
.. image:: credit_notes/credit_notes03.png
:align: center
And here is the credit notes journal entry generated to reverse
the original invoice above:
.. image:: media/credit_notes04.png
.. image:: credit_notes/credit_notes04.png
:align: center
@@ -36,7 +36,7 @@ Configure a Deferred Revenue 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_revenues01.png
.. image:: deferred_revenues/deferred_revenues01.png
:align: center
:alt: Configuration of a Deferred Revenue Account in Odoo Accounting
@@ -52,7 +52,7 @@ Select the account on a draft invoice
On a draft invoice, select the right account for all the products of which the incomes must be
deferred.
.. image:: media/deferred_revenues02.png
.. image:: deferred_revenues/deferred_revenues02.png
:align: center
:alt: Selection of a Deferred Revenue Account on a draft invoice in Odoo Accounting
@@ -62,7 +62,7 @@ Choose a different Income Account for specific products
Start editing the product, go to the *Accounting* tab, select the right **Income Account**, and
save.
.. image:: media/deferred_revenues03.png
.. image:: deferred_revenues/deferred_revenues03.png
:align: center
:alt: Change of the Income Account for a product in Odoo
@@ -77,7 +77,7 @@ To do so, open your Sales Journal by going to
:menuselection:`Accounting --> Accounting --> Sales`, select the journal item you
want to modify, click on the account, and select the right one.
.. image:: media/deferred_revenues04.png
.. image:: deferred_revenues/deferred_revenues04.png
:align: center
:alt: Modification of a posted journal item's account in Odoo Accounting
@@ -97,7 +97,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
Sales** tab.
.. image:: media/deferred_revenues05.png
.. image:: deferred_revenues/deferred_revenues05.png
:align: center
:alt: Deferred Revenue entry in Odoo Accounting
@@ -105,7 +105,7 @@ Once done, you can click on *Compute Revenue* (next to the *Confirm* button) to
values of the **Revenue Board**. This board shows you all the entries that Odoo will post to
recognize your revenue, and at which date.
.. image:: media/deferred_revenues06.png
.. image:: deferred_revenues/deferred_revenues06.png
:align: center
:alt: Revenue Board in Odoo Accounting
@@ -134,7 +134,7 @@ Make sure that it is posted in the right account (see:
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_revenues07.png
.. image:: deferred_revenues/deferred_revenues07.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_revenues08.png
.. image:: deferred_revenues/deferred_revenues08.png
:align: center
:alt: Deferred Revenue model button in Odoo Accounting
@@ -182,7 +182,7 @@ You have three choices for the **Automate Deferred Revenue** field:
`Deferred Revenue Models`_). Whenever a transaction is posted on the account, a *Deferred
Revenues entry* is created and immediately validated.
.. image:: media/deferred_revenues09.png
.. image:: deferred_revenues/deferred_revenues09.png
:align: center
:alt: Automate Deferred Revenue on an account in Odoo Accounting
@@ -21,7 +21,7 @@ Configuration
Go to :menuselection:`Accounting --> Configuration --> Settings`
and activate the **SEPA QR Code** feature.
.. image:: media/epc_qr_code01.png
.. image:: epc_qr_code/epc_qr_code01.png
:align: center
Configure your Bank Accounts journal
@@ -33,7 +33,7 @@ To do so, go to :menuselection:`Accounting --> Configuration
--> Journals`, open your *bank journal*, then fill out the
*Bank Account* and *Bank* under the *Bank Account* tab.
.. image:: media/epc_qr_code02.png
.. image:: epc_qr_code/epc_qr_code02.png
:align: center
Issue Invoices with EPC QR Codes
@@ -52,7 +52,7 @@ Make sure that the account indicated is the one you want to use to
receive your customers payment as Odoo uses this field to generate
the EPC QR Code.
.. image:: media/epc_qr_code03.png
.. image:: epc_qr_code/epc_qr_code03.png
:align: center
.. tip::
@@ -13,7 +13,7 @@ Set up Snailmail
| If you would like this option to be a default feature, enable *Send by Post* under
*Default Sending Options*.
.. image:: media/setup_snailmail.png
.. image:: snailmail/setup_snailmail.png
:align: center
:alt: Under settings enable the snailmail feature in Odoo Accounting
@@ -22,7 +22,7 @@ Send your invoices by post
Open your Invoice, click on the *Send & Print* button and select *Send by Post*.
.. image:: media/invoice_bypost.png
.. image:: snailmail/invoice_bypost.png
:align: center
:alt: Overview of an invoice and the option send by post available in Odoo Accounting
@@ -27,7 +27,7 @@ To do so, go to :menuselection:`Accounting --> Configuration --> Journals`, open
you want to edit, click on *Edit*, and open the *Advanced Settings* tab. In the *Payment Method
Types* section, enable **Batch Deposit**, and click on *Save*.
.. image:: media/batch-journal-settings.png
.. image:: batch/batch-journal-settings.png
:align: center
:alt: Payment Method Types in a journal's advanced settings
@@ -46,7 +46,7 @@ opening the *Customer Invoice* for which you received a payment, and clicking on
There, select the appropriate Journal linked to your bank account and select *Batch Deposit* as
Payment Method.
.. image:: media/batch-register-payment.png
.. image:: batch/batch-register-payment.png
:align: center
:alt: Registering a customer payment as part of a Batch Deposit in Odoo Accounting
@@ -62,14 +62,14 @@ To add the payments to a Batch Deposit, go to :menuselection:`Accounting --> Cus
Payments`, and click on *Create*. Next, select the Bank and Payment Method, then click on *Add a
line*.
.. image:: media/batch-new-inbound.png
.. image:: batch/batch-new-inbound.png
:align: center
:alt: Filling out a new Inbound Batch Payment form on Odoo Accounting
Select all payments to include in the current Batch Deposit and click on *Select*. You can also
record a new payment and add it to the list by clicking on *Create*.
.. image:: media/batch-payments-selection.png
.. image:: batch/batch-payments-selection.png
:align: center
:alt: Selection of all payments to include in the Batch Deposit
@@ -88,7 +88,7 @@ tab, and select your Batch Payment. All related payments are automatically added
.. note::
The *Batch Payments* tab won't appear if a Partner is selected for this bank statement line.
.. image:: media/batch-bank-reconciliation.png
.. image:: batch/batch-bank-reconciliation.png
:align: center
:alt: Reconciliation of the Batch Payment with all its transactions
@@ -23,7 +23,7 @@ Go to :menuselection:`Accounting --> Configuration --> Settings`, activate **SEP
(SDD)** and click on *Save*. Enter your company's **Creditor Identifier**. This number is provided
by your bank institution, or the authority responsible for delivering them.
.. image:: media/batch-sdd-creditor-identifier.png
.. image:: batch_sdd/batch-sdd-creditor-identifier.png
:align: center
:alt: Add a SEPA Creditor Identifier to Odoo Accounting
@@ -39,7 +39,7 @@ money directly from their bank accounts.
To create a new mandate, go to :menuselection:`Accounting --> Customers --> Direct Debit Mandates`,
click on *Create*, and fill out the form.
.. image:: media/batch-sdd-mandate-form.png
.. image:: batch_sdd/batch-sdd-mandate-form.png
:align: center
:alt: Fill out SEPA Direct Debit in Odoo Accounting
@@ -78,7 +78,7 @@ Close or revoke a mandate
Direct Debit mandates are closed automatically after their *End Date*. If this field is left blank,
the mandate keeps being *Active* until it is *Closed* or *Revoked*.
.. image:: media/batch-sdd-revoke-close.png
.. image:: batch_sdd/batch-sdd-revoke-close.png
:align: center
:alt: Close or Revoke an SDD Mandate in Odoo Accounting
@@ -117,21 +117,21 @@ process all payments at once.
To generate your XML file for the pending SDD payments, go to the related *bank journal* on your
*Accounting dashboard*, then click on *Direct Debit Payments to Collect*.
.. image:: media/batch-sdd-collect.png
.. image:: batch_sdd/batch-sdd-collect.png
:align: center
:alt: Start the SDD payments collection in Odoo Accounting
Select all the payments you want to include in your SDD XML file, then click on *Action* and select
*Create Batch Payment*.
.. image:: media/batch-sdd-batch.png
.. image:: batch_sdd/batch-sdd-batch.png
:align: center
:alt: Create a batch payment with all the SDD payments in Odoo Accounting
Odoo then takes you to your *Batch Payment*s form. Click on *Validate* and download the SDD XML
file.
.. image:: media/batch-sdd-xml.png
.. image:: batch_sdd/batch-sdd-xml.png
:align: center
:alt: Generate an XML file for your SDD payments in Odoo Accounting
@@ -59,7 +59,7 @@ on **Register Payment**. Fill in the information about the payment:
- Memo: write the Check number
.. image:: ./media/check02.png
.. image:: check/check02.png
:align: center
This operation will produce the following journal entry:
@@ -115,7 +115,7 @@ on **Register Payment**. Fill in the information about the payment:
- Memo: write the check number
.. image:: ./media/check03.png
.. image:: check/check03.png
:align: center
The invoice is marked as paid as soon as you record the check.
@@ -147,5 +147,5 @@ report **Bank Reconciliation Report** to verify which checks have been
received or paid by the bank. (this report is available from the **More**
option from the Accounting dashboard on the related bank account).
.. image:: ./media/check01.png
.. image:: check/check01.png
:align: center
@@ -33,7 +33,7 @@ Date* set on the statement.
You can also set a trust level for your customers by marking them as
bad, normal or good debtors on the follow-up reports.
.. image:: media/followup01.png
.. image:: followup/followup01.png
:align: center
Send reminders in batch
@@ -45,7 +45,7 @@ like to process, click on *Action* and then on *Process Follow-ups*.
A pdf document containing all of the follow-up letters for you to print
will also be automatically generated.
.. image:: media/followup02.png
.. image:: followup/followup02.png
:align: center
Plan a follow-up process
@@ -62,7 +62,7 @@ number of overdue days, plan to send an email, a letter or to undertake
a manual action. You can also edit the template used for the statement
according to the stage of the process.
.. image:: media/followup03.png
.. image:: followup/followup03.png
:align: center
.. tip::
@@ -7,7 +7,7 @@ To make it more convenient for your customers to pay the invoices you issue, you
allows your customers to see their invoices online and pay directly with their favorite payment
method, making the payment process much easier.
.. image:: media/online-payment-acquirers.png
.. image:: online_payment/online-payment-acquirers.png
:align: center
:alt: Payment acquirer choice after having clicked on "Pay Now"
@@ -30,13 +30,13 @@ After issuing the invoice, click on *Send & Print* and send the invoice by email
They will receive an email with a link that redirects them to the invoice on their **Customer
Portal**.
.. image:: media/online-payment-view-invoice.png
.. image:: online_payment/online-payment-view-invoice.png
:align: center
:alt: Email with a link to view the invoice online on the Customer Portal.
They can choose which Payment Acquirer to use by clicking on *Pay Now*.
.. image:: media/online-payment-pay-now.png
.. image:: online_payment/online-payment-pay-now.png
:align: center
:alt: "Pay now" button on an invoice in the Customer Portal.
@@ -21,7 +21,7 @@ If you register a payment on a customer invoice or a vendor bill, the
payment is automatically reconciled with the invoice reducing the amount
due.
.. image:: ./media/recording01.png
.. image:: recording/recording01.png
:align: center
The green icon near the payment line will display more information about
@@ -45,7 +45,7 @@ Sales menu (register a customer payment) or the Purchases menu (pay a
vendor). If you use these menus, the payment is not linked to an
invoice, but can easily be reconciled on an invoice later on.
.. image:: ./media/recording02.png
.. image:: recording/recording02.png
:align: center
When registering a new payment, you must select a customer or vendor,
@@ -68,7 +68,7 @@ payment for this customer or vendor is available. In this case, you can
reconcile this payment to the invoice near the totals at the bottom,
under "Outstanding Payments".
.. image:: ./media/recording03.png
.. image:: recording/recording03.png
:align: center
Reconciling all your outstanding payments and invoices
@@ -82,14 +82,14 @@ The batch reconciliation feature is available from the dashboard on the
Customer Invoices card and the Vendor Bills card for reconciling
Accounts Receivable and Payable, respectively.
.. image:: ./media/recording04.png
.. image:: recording/recording04.png
:align: center
The payments matching tool will open all unreconciled customers or
vendors and will give you the opportunity to process them all one by
one, doing the matching of all their payments and invoices at once.
.. image:: ./media/recording05.png
.. image:: recording/recording05.png
:align: center
During the reconciliation, if the sum of the debits and credits do not
@@ -103,13 +103,13 @@ Just like making a customer or vendor payment, you transfer cash
internally between your bank accounts from the dashboard or from the
menus up top.
.. image:: ./media/recording06.png
.. image:: recording/recording06.png
:align: center
This will take you to the same screen you have for receiving and making
payments.
.. image:: ./media/recording07.png
.. image:: recording/recording07.png
:align: center
.. note::