[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#2064
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:58:14 +00:00
parent fbb1cfc90f
commit 17df8c547a
2048 changed files with 1770 additions and 1769 deletions
@@ -7,13 +7,13 @@ Product Catalog
All your published items show up in your catalog page (or *Shop* page).
.. image:: ./media/shop.png
.. image:: catalog/shop.png
:align: center
Most options are available in the *Customize* menu: display attributes,
website categories, etc.
.. image:: ./media/shop_customize.png
.. image:: catalog/shop_customize.png
:align: center
Highlight a product
@@ -33,5 +33,5 @@ the catalog page. To do so, add product description and add to cart button. Turn
options in *Customize* menu: Product Description, Add to Cart, List View (to display product
description better).
.. image:: ./media/shop_list.png
.. image:: catalog/shop_list.png
:align: center

Before

Width:  |  Height:  |  Size: 112 KiB

After

Width:  |  Height:  |  Size: 112 KiB

@@ -6,17 +6,17 @@ On the website click *New Page* in the top-right corner.
Then click *New Product* and follow the blinking tips.
.. image:: ./media/create_product.png
.. image:: product_page/create_product.png
:align: center
Here are the main elements of the Product page:
.. image:: ./media/product_page_tips.png
.. image:: product_page/product_page_tips.png
:align: center
Many elements can be made visible from the *Customize* menu.
.. image:: ./media/product_customize.png
.. image:: product_page/product_customize.png
:align: center
See how to configure your products from links here below.