[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
@@ -19,7 +19,7 @@ Register your application with the Microsoft identity platform
.. note::
When configuring your platform settings, choose *Web*.
.. image:: media/platform_configurations.png
.. image:: outlook_calendar/platform_configurations.png
:align: center
:alt: Adding a platform in Microsoft Azure for Outlook calendar sync in Odoo
@@ -27,7 +27,7 @@ Register your application with the Microsoft identity platform
| For the **Redirect URI restrictions**, copy your Odoo database URI followed by
``/microsoft_account/authentication``. Example:
.. image:: media/redirect_URIs.png
.. image:: outlook_calendar/redirect_URIs.png
:align: center
:alt: Odoo's database URI that is accepted when microsoft returns authentication
@@ -43,21 +43,21 @@ Configuration in Odoo
Go to general *Settings* and activate the *Outlook Calendar* feature.
.. image:: media/outlook_calendar.png
.. image:: outlook_calendar/outlook_calendar.png
:align: center
:alt: Outlook Calendar feature activated in Odoo
From your Azure portal, under *Overview*, copy your *Application (client) ID*, and paste it to
*Client ID* in Odoo.
.. image:: media/application_client_ID.png
.. image:: outlook_calendar/application_client_ID.png
:align: center
:alt: Client ID token to be copied from Microsoft to Odoo
Going back to your Azure portal, now under *Certificates & secrets*, copy your *Client Secret Value*
and paste it to *Client Secret* in Odoo.
.. image:: media/client_secrets.png
.. image:: outlook_calendar/client_secrets.png
:align: center
:alt: Client Secret token to be copied from Microsoft to Odoo
@@ -75,21 +75,21 @@ Sync with Outlook
created in Outlook, and therefore, no redundant emails will be sent during the first
synchronization. After the sync, events will only send one confirmation email.
.. image:: media/archive_odoocalendar.png
.. image:: outlook_calendar/archive_odoocalendar.png
:align: center
:alt: Archive events in Odoo Calendar
Go to the *Calendar* application and *Sync with Outlook*. You are asked to log in to
your account, if you are not already, and grant the required permissions.
.. image:: media/sync_with_outlook.png
.. image:: outlook_calendar/sync_with_outlook.png
:align: center
:alt: Calendar view and the button Sync with Outlook in Odoo Calendar
The synchronization is a two-way process, meaning that events are reconciled in both accounts
(Outlook and Odoo).
.. image:: media/synched_with_outlook.png
.. image:: outlook_calendar/synched_with_outlook.png
:align: center
:alt: View of Odoo's Calendar synched with Outlook's Calendar