[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
@@ -35,7 +35,7 @@ create a new *Subscription template* or modify an existing one. When editing you
the Invoicing tab, you have the possibility to activate the option *Closable by customer*.
Once enabled, this option gives your customers the right to close their own subscriptions.
.. image:: media/configuration-to-close-your-subscriptions.png
.. image:: closing/configuration-to-close-your-subscriptions.png
:align: center
:alt: Configuration to close your subscription with Odoo Subscriptions
@@ -55,7 +55,7 @@ Once confirmed, a quotation becomes a sales order and a new subscription is auto
Therefore, this subscription has the status *In progress*. From there, you have the possibility to
close the subscription.
.. image:: media/close-your-subscriptions-as-an-administrator.png
.. image:: closing/close-your-subscriptions-as-an-administrator.png
:align: center
:alt: Close your subscription from an administration point of view with Odoo Subscriptions
@@ -64,7 +64,7 @@ expensive", "Subscription does not meet my requirements", "Subscription reached
Immediately after confirming your close reason, you can observe that the status of the subscription
is now *Closed* and that the close reason is mentioned on the subscription.
.. image:: media/use-of-close-reasons.png
.. image:: closing/use-of-close-reasons.png
:align: center
:alt: What happens when you close your subscription with Odoo Subscriptions?
@@ -76,14 +76,14 @@ the possibility to visualize what your customers see when managing their subscri
*Customer preview* button. In this example, the customer has the choice to close his/her subscription
whenever he/she wants to, due to the *Close Subscription* button.
.. image:: media/close-your-subscriptions-as-a-customer.png
.. image:: closing/close-your-subscriptions-as-a-customer.png
:align: center
:alt: Close your subscription from a customer point of view with Odoo Subscriptions
By using this button, the customer can specify the reason for cancelling his/her subscription and
he/she can even leave a message.
.. image:: media/use-of-close-reasons-as-a-customer.png
.. image:: closing/use-of-close-reasons-as-a-customer.png
:align: center
:alt: What happens when customers close their subscription with Odoo Subscriptions?
@@ -92,7 +92,7 @@ informed of this modification. Indeed, the status of the subscription becomes *C
appears in the chatter with the new stage, the end date, the close reason, and the closing text
added by the customer.
.. image:: media/chatter-history-when-a-customer-closes-a-subscription.png
.. image:: closing/chatter-history-when-a-customer-closes-a-subscription.png
:align: center
:alt: What happens when customers close their subscription in Odoo Subscriptions?
@@ -32,7 +32,7 @@ to your templates.
Go to **Odoo Sales** and create a new quotation. Then, choose a customer and add a product.
Be careful to select a product that you previously configured as a *Subscription product*.
.. image:: media/create-a-quotation-using-subscription-products.png
.. image:: create_a_quotation/create-a-quotation-using-subscription-products.png
:align: center
:alt: View of a quotation form in Odoo Sales
@@ -41,7 +41,7 @@ it. It is better to first *Send by email* the quotation to your customers to hav
and, then, *Confirm* it in **Odoo Sales**. By clicking on *Customer preview*, you have an idea of
what your customers will see when receiving your quotation.
.. image:: media/customer-preview-of-a-quotation-using-subscription-products.png
.. image:: create_a_quotation/customer-preview-of-a-quotation-using-subscription-products.png
:align: center
:alt: Customer preview of a quotation form in Odoo Sales
@@ -56,7 +56,7 @@ Manage your subscriptions from your SO
Once confirmed, the quotation becomes a sales order and a new button appears, *Subscriptions*.
Indeed, a subscription is automatically created.
.. image:: media/manage-your-subscriptions-from-your-sales-order.png
.. image:: create_a_quotation/manage-your-subscriptions-from-your-sales-order.png
:align: center
:alt: Quotation form in Odoo Sales with a button "Subscriptions"
@@ -66,7 +66,7 @@ By clicking on the *Subscriptions* button, you can see that the status of the su
:doc:`Close <../../subscriptions/sales_flow/closing>` or
:doc:`Upsell <../../subscriptions/sales_flow/upselling>` your subscription.
.. image:: media/use-of-the-subscriptions-button-in-odoo-sales.png
.. image:: create_a_quotation/use-of-the-subscriptions-button-in-odoo-sales.png
:align: center
:alt: Use of the intelligent button "Subscriptions" in Odoo Sales
@@ -30,7 +30,7 @@ have the possibility to renew the subscription. In the Other Info tab, underneat
section, you can activate the *To renew* option. When activated, a yellow tag automatically appears
in the upper right corner of the subscription.
.. image:: media/renew-your-subscription.png
.. image:: renewals/renew-your-subscription.png
:align: center
:alt: Renew your subscription with Odoo Subscriptions
@@ -39,7 +39,7 @@ in the upper right corner of the subscription.
on the customer portal. To visualize that, you just have to click on the *Customer preview*
button. The tag *To renew* appears on the top right corner.
.. image:: media/customer-preview-of-a-renewal.png
.. image:: renewals/customer-preview-of-a-renewal.png
:align: center
:alt: Customer preview of a renewal with Odoo Subscriptions
@@ -54,7 +54,7 @@ first *Send by email* the quotation to your customers in order to have their con
from the previous subscription". Once confirmed by your customers, this quotation becomes a
sales order and a new sale is mentioned in the upper right corner of the subscription.
.. image:: media/renew-a-quotation.png
.. image:: renewals/renew-a-quotation.png
:align: center
:alt: Renew a quotation with Odoo Subscriptions
@@ -62,7 +62,7 @@ first *Send by email* the quotation to your customers in order to have their con
The only difference between your two quotations is the description underneath the
*Subscription Management* category. There, you can easily visualize which one is your renewal.
.. image:: media/subscription-management-category.png
.. image:: renewals/subscription-management-category.png
:align: center
:alt: Renewal as Subscription Management form in Odoo Subscriptions
@@ -72,7 +72,7 @@ Visualize your subscriptions to renew
Finally, if you want to visualize all your subscriptions and easily find those to renew, you can go
to your *Subscriptions dashboard* and use the filter *To renew*.
.. image:: media/subscriptions-dashboard-with-the-to-renew-filter.png
.. image:: renewals/subscriptions-dashboard-with-the-to-renew-filter.png
:align: center
:alt: List view of all subscriptions and use of the filter to renew in Odoo Subscriptions
@@ -28,7 +28,7 @@ As previously explained, to upsell a subscription to new customers, it is recomm
*Discounts*. To activate this option, go to :menuselection:`Sales --> Configuration --> Settings` and,
under the *Pricing* category, you have the possibility to grant discounts on sales order lines.
.. image:: media/configuration-to-upsell-a-subscription.png
.. image:: upselling/configuration-to-upsell-a-subscription.png
:align: center
:alt: Activation of the discount option in Odoo Sales
@@ -41,14 +41,14 @@ products. Indeed, once confirmed, a quotation becomes a sales order and a new su
automatically created. Therefore, this subscription has the status *In progress*. From there, you
have the possibility to upsell your subscription.
.. image:: media/upsell-your-subscription.png
.. image:: upselling/upsell-your-subscription.png
:align: center
:alt: Upsell your subscription with Odoo Subscriptions
By using the smart button *Upsell*, you are able to create a new quotation with new subscription
products and send it to your customers for approval.
.. image:: media/use-of-the-upsell-button-in-odoo-sales.png
.. image:: upselling/use-of-the-upsell-button-in-odoo-sales.png
:align: center
:alt: Add products to your subscription via the upsell option in Odoo Subscriptions
@@ -65,14 +65,14 @@ click on the smart button *Subscriptions* to visualize all updates. From there,
additional line has been added to the subscription with the new extra service the customer wanted to
purchase.
.. image:: media/subscriptions-updates.png
.. image:: upselling/subscriptions-updates.png
:align: center
:alt: Visualize all your subscriptions updates with Odoo Subscriptions
In addition, by clicking on the *Sales* button, you have a summary of your sales orders in a list
view.
.. image:: media/sales-order-updates.png
.. image:: upselling/sales-order-updates.png
:align: center
:alt: List view of all sales orders created for a subscription