[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#2068
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:54:32 +00:00
parent 3901e3b241
commit 8722ea902e
2056 changed files with 1777 additions and 1776 deletions
@@ -12,7 +12,7 @@ Public and Private channels
A *Public* channel can be seen by everyone, while a *Private* one is only visible to users invited
to it.
.. image:: media/create_channel.png
.. image:: team_communication/create_channel.png
:align: center
:height: 370
:alt: View of discusss sidebar and a channel being created in Odo Discuss
@@ -28,7 +28,7 @@ Configuration options
You can configure a channels name, description, email alias, and privacy by clicking on the
*Channel Settings* icon on the sidebar.
.. image:: media/channel_settings.png
.. image:: team_communication/channel_settings.png
:align: center
:alt: View of a channels settings form in Odoo Discuss
@@ -41,7 +41,7 @@ Privacy and Members
| If you choose *Invited people only*, go to the *Members* tab to add your members, or, go to
Discuss main page, select the channel and click on *Invite*.
.. image:: media/invite_channel.png
.. image:: team_communication/invite_channel.png
:align: center
:height: 380
:alt: View of Discuss sidebar emphasizing the option to invite members in Odoo Discuss
@@ -58,7 +58,7 @@ Use a channel as a mailing list
| Enabling this option allows you to *Moderate this channel*, meaning that messages will need to be
approved before being sent.
.. image:: media/pending_moderation.png
.. image:: team_communication/pending_moderation.png
:align: center
:alt: View of a message with a pending moderation status in Odoo Discuss
@@ -66,13 +66,13 @@ Use a channel as a mailing list
receive an *Automatic notification*.
| Mark *Send guidelines to new subscribers* to automatically send instructions to newcomers.
.. image:: media/moderation_settings.png
.. image:: team_communication/moderation_settings.png
:align: center
:alt: View of a channels settings form emphasizing the tab moderation in Odoo Discuss
Moderators can: *Accept*, *Reject*, *Discard*, *Always Allow* or *Ban* messages.
.. image:: media/moderate_messages.png
.. image:: team_communication/moderate_messages.png
:align: center
:alt: View of a message to be moderated in Odoo Discuss
@@ -83,7 +83,7 @@ Moderators can: *Accept*, *Reject*, *Discard*, *Always Allow* or *Ban* messages.
Once a channel is moderated, the menu *Ban List* allows you to add email addresses per moderated
channel to auto-ban them from sending messages.
.. image:: media/ban_list.png
.. image:: team_communication/ban_list.png
:align: center
:alt: View of a channels setting form emphasizing the ban Lists menu in Odoo Discuss
@@ -94,7 +94,7 @@ Once at least 20 channels, direct message and live chat conversations (if the mo
on your database) are pinned in the sidebar, a *Quick search…* bar is displayed. It is a clever
way to filter conversations and quickly find the one you need.
.. image:: media/quick_search.png
.. image:: team_communication/quick_search.png
:align: center
:height: 430
:alt: View of the Discuss sidebar emphasizing the quick search bar in Odoo Discuss
@@ -107,7 +107,7 @@ Finding channels
| Apply filters criteria and save it for later use. The search function accepts wildcards by using
the underscore character *(_)* to represent a single character.
.. image:: media/filter.png
.. image:: team_communication/filter.png
:align: center
:alt: View of a channel being searched through filters in Odoo Discuss