[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#2026
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:57:14 +00:00
parent a658e160aa
commit 91c20a2c03
2078 changed files with 1805 additions and 1804 deletions
@@ -31,7 +31,7 @@ and go to the **Tax Return Periodicity** section.
- **Reminder**: define when Odoo should remind you to file your tax return.
- **Journal**: select the journal in which to record the tax return.
.. image:: media/tax_return_periodicity.png
.. image:: tax_returns/tax_return_periodicity.png
:align: center
:alt: Configure how often tax returns have to be made in Odoo Accounting
@@ -46,7 +46,7 @@ Odoo generates Tax Reports based on the **Tax Grids** settings that are configur
Therefore, it is crucial to make sure that all the recorded transactions use the right taxes. You
can see on each Journal Item which Tax Grid is used for that transaction.
.. image:: media/tax_return_grids.png
.. image:: tax_returns/tax_return_grids.png
:align: center
:alt: see which tax grids are used to record transactions in Odoo Accounting
@@ -54,7 +54,7 @@ To configure your taxes' Tax Grids, go to :menuselection:`Accounting --> Configu
and open the tax you want to modify. There, you can edit your tax settings, along with the tax
grids that are used to record invoices or credit notes.
.. image:: media/tax_return_taxes.png
.. image:: tax_returns/tax_return_taxes.png
:align: center
:alt: Configure taxes and their tax grids in Odoo Accounting
@@ -83,7 +83,7 @@ Entry, which helps you avoid some tax declaration errors.
To check the current **Tax Lock Date**, or to edit it, go to :menuselection:`Accounting -->
Accounting --> Lock Dates`.
.. image:: media/tax_return_lock.png
.. image:: tax_returns/tax_return_lock.png
:align: center
:alt: Lock your tax for a specific period in Odoo Acounting
@@ -99,7 +99,7 @@ on *TAX Report* from your *Accounting Overview*.
Make sure to select the right period you want to declare by using the date filter. You can see an
overview of your tax report. Then, click on the button *Closing Journal Entry*.
.. image:: media/tax_return_closing.png
.. image:: tax_returns/tax_return_closing.png
:align: center
:alt: Select the period for the tax return and create a closing journal entry in Odoo Accounting
@@ -108,7 +108,7 @@ Odoo automatically creates a PDF file with the **Tax Report** that you can downl
and preview on the right column. It includes all the values to report to the tax authorities, along
with the amount you have to pay or be refunded.
.. image:: media/tax_return_report.png
.. image:: tax_returns/tax_return_report.png
:align: center
:alt: download the PDF with your Tax Report in Odoo Accounting
@@ -22,7 +22,7 @@ Create your financial report
First, you need to create your financial report. To do that, go to
:menuselection:`Accounting --> Configuration --> Financial Reports`
.. image:: media/customize02.png
.. image:: customize/customize02.png
:align: center
Once the name is entered, there are two other parameters that need to be
@@ -49,7 +49,7 @@ After you've created the report, you need to fill it with lines. They
all need a **name**, a **code** (that is used to refer to the line), a
**sequence number** and a **level** (Used for the line rendering).
.. image:: media/customize04.png
.. image:: customize/customize04.png
:align: center
In the **formulas** field you can add one or more formulas to assign a
@@ -31,7 +31,7 @@ Balance Sheet
The **Balance Sheet** shows a snapshot of the assets, liabilities and equity
of your organisation as at a particular date.
.. image:: media/main_reports09.png
.. image:: main_reports/main_reports09.png
:align: center
Profit and Loss
@@ -41,7 +41,7 @@ The **Profit and Loss** report (or **Income Statement**) shows your
organisation's net income, by deducting expenses from revenue for the
report period.
.. image:: media/main_reports10.png
.. image:: main_reports/main_reports10.png
:align: center
Executive Summary
@@ -87,7 +87,7 @@ reporting :
typically used as as a measure of a company's ability to service
its debt.
.. image:: media/main_reports01.png
.. image:: main_reports/main_reports01.png
:align: center
General Ledger
@@ -99,7 +99,7 @@ account and from there you can view a detailed transaction report or any
exceptions. This report is useful for checking every transaction that
occurred during a certain period of time.
.. image:: media/main_reports05.png
.. image:: main_reports/main_reports05.png
:align: center
Aged Payable
@@ -109,7 +109,7 @@ Run the **Aged Payable Details** report to display information on individual
bills, credit notes and overpayments owed by you, and how long these
have gone unpaid.
.. image:: media/main_reports02.png
.. image:: main_reports/main_reports02.png
:align: center
Aged Receivable
@@ -118,7 +118,7 @@ Aged Receivable
The **Aged Receivables** report shows the sales invoices that were awaiting
payment during a selected month and several months prior.
.. image:: media/main_reports07.png
.. image:: main_reports/main_reports07.png
:align: center
Cash Flow Statement
@@ -128,7 +128,7 @@ The **Cash Flow Statement** shows how changes in balance sheet accounts and
income affect cash and cash equivalents, and breaks the analysis down to
operating, investing and financing activities.
.. image:: media/main_reports03.png
.. image:: main_reports/main_reports03.png
:align: center
Tax Report
@@ -137,11 +137,11 @@ Tax Report
This report allows you to see the **net** and **tax amounts** for all the taxes
grouped by type (sale/purchase).
.. image:: media/main_reports04.png
.. image:: main_reports/main_reports04.png
:align: center
Bank Reconciliation
-------------------
.. image:: media/main_reports06.png
.. image:: main_reports/main_reports06.png
:align: center