[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
@@ -14,7 +14,7 @@ Choose your notifications preference
Access your *Preferences* and choose how you would like your notifications to be handled.
.. image:: media/change_preferences.png
.. image:: get_started/change_preferences.png
:align: center
:alt: View of the preferences page for Odoo Discuss
@@ -23,14 +23,14 @@ Access your *Preferences* and choose how you would like your notifications to be
they are shown in the *Inbox*.
| Messages can then be *Marked as Todo*, *Replied*, or *Marked as Read*.
.. image:: media/inbox_actions.png
.. image:: get_started/inbox_actions.png
:align: center
:alt: View of an inbox message and its action options in Odoo Discuss
The messages tagged as *Mark as Todo* are also shown in *Starred*, while the ones *Marked as Read*
are moved to *History*.
.. image:: media/starred_messages.png
.. image:: get_started/starred_messages.png
:align: center
:alt: View of messages marked as todo in Odoo Discuss
@@ -41,7 +41,7 @@ The first time you log in to your account, OdooBot sends you a message asking fo
receive desktop notifications to chats. If accepted, you receive push notifications to the messages
sent to you despite of where you are in Odoo.
.. image:: media/odoobot_push.png
.. image:: get_started/odoobot_push.png
:align: center
:alt: View of the messages under the messaging menu emphasizing the request for push
notifications for Odoo Discuss
@@ -52,7 +52,7 @@ sent to you despite of where you are in Odoo.
To start a chat, click on *New Message* on the *Messaging Menu*, or go to *Discuss* and send a
*Direct Message*.
.. image:: media/channels_direct_messages.png
.. image:: get_started/channels_direct_messages.png
:align: center
:height: 400
:alt: View of discusss panel emphasizing the titles channels and direct messages in Odoo Discuss
@@ -67,7 +67,7 @@ Mentions in the chat and on the Chatter
| A notification is sent to the user mentioned either to his *Inbox* or through email, depending
on his settings.
.. image:: media/chat_windows.png
.. image:: get_started/chat_windows.png
:align: center
:alt: View of a couple of chat window messages for Odoo Discuss
@@ -88,7 +88,7 @@ sidebar and on the *Messaging menu*.
- White = offline
- Airplane = out of the office
.. image:: media/status.png
.. image:: get_started/status.png
:align: center
:height: 300
:alt: View of the contacts status for Odoo Discuss

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

@@ -11,7 +11,7 @@ Where do I see my schedule activities?
Access and manage your activities wherever you are in Odoo by the *Activities* menu.
.. image:: media/activities_menu.png
.. image:: plan_activities/activities_menu.png
:align: center
:height: 300
:alt: View of crm leads page emphasizing the activities menu for Odoo Discuss
@@ -22,7 +22,7 @@ Plan activities
Activities can be planned and managed from the chatter by clicking on *Schedule activity*,
or through Kanban views.
.. image:: media/schedule_activity.png
.. image:: plan_activities/schedule_activity.png
:align: center
:height: 300
:alt: View of crm leads and the option to schedule an activity for Odoo Discuss
@@ -33,7 +33,7 @@ Set your activity types
A number of activities types are available by default in Odoo (call, email, meeting, etc.). However,
you can set new ones going to :menuselection:`Settings --> Activity types`.
.. image:: media/settings_activities_types.png
.. image:: plan_activities/settings_activities_types.png
:align: center
:height: 300
:alt: View of the settings page emphasizing the menu activity types for Odoo Discuss
@@ -47,7 +47,7 @@ Recommend next activities
Odoo helps you to plan a flow of activities by allowing you to set *Recommended Next Activities*.
.. image:: media/recommended_activities.png
.. image:: plan_activities/recommended_activities.png
:align: center
:alt: View of an activity type form emphasizing the field recommended next activities for Odoo
Discuss
@@ -55,7 +55,7 @@ Odoo helps you to plan a flow of activities by allowing you to set *Recommended
Once the respective activity is completed, select *Done & Schedule Next* and next steps are
suggested to you.
.. image:: media/schedule_recommended_activity.png
.. image:: plan_activities/schedule_recommended_activity.png
:align: center
:alt: View of an activity being schedule emphasizing the recommended activities field being
shown for Odoo Discuss
@@ -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

Before

Width:  |  Height:  |  Size: 42 KiB

After

Width:  |  Height:  |  Size: 42 KiB