[MOV] calendar: "Calendar" app from "Misc" to "Productivity"

To improve the structure of the documentation, the "Miscellaneous"
section should be limited as much as possible.

This commit:
- renames "Calendars" into "Calendar" (as the app name)
- moves the app from the "Miscellaneous" section to the "Productivity"
  section
- fixes the wrong file structure to follow the toc
  (e.g. general/calendars/outlook/outlook_calendar -> productivity/calendar/outlook)

task-3217827

closes odoo/documentation#4128

X-original-commit: 3d2c5d7c16
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>

content/administration/maintain/azure_oauth.rst

@@ -13,7 +13,7 @@ personal email address or an address created by a custom domain.
 
 .. seealso::
    - :doc:`/applications/general/auth/azure`
-   - :doc:`/applications/general/calendars/outlook/outlook_calendar`
+   - :doc:`/applications/productivity/calendar/outlook`
 
 Setup in Microsoft Azure Portal
 ===============================

content/administration/maintain/google_oauth.rst

@@ -13,7 +13,7 @@ email address or an address created by a custom domain.
 
 .. seealso::
    - :doc:`/applications/general/auth/google`
-   - :doc:`/applications/general/calendars/google/google_calendar_credentials`
+   - :doc:`/applications/productivity/calendar/google`
 
 Setup in Google
 ===============

content/applications/general.rst

@@ -12,7 +12,6 @@ Miscellaneous
     general/reporting
     general/email_communication
     general/voip
-    general/calendars
     general/digest_emails
     general/in_app_purchase
     general/developer_mode

content/applications/general/auth/azure.rst

@@ -6,5 +6,5 @@ Due to specific requirements in Azure's OAuth implementation, Microsoft Azure OA
 is NOT compatible with Odoo at the moment.
 
 .. seealso::
-   - :doc:`/applications/general/calendars/outlook/outlook_calendar`
+   - :doc:`../../productivity/calendar/outlook`
    - :doc:`/administration/maintain/azure_oauth`

content/applications/general/auth/google.rst

@@ -9,7 +9,7 @@ This is particularly helpful if your organization uses Google Workforce and you
 within your organization to connect to Odoo with their Google Accounts.
 
 .. seealso::
-   - :doc:`/applications/general/calendars/google/google_calendar_credentials`
+   - :doc:`../../productivity/calendar/google`
    - :doc:`/administration/maintain/google_oauth`
 
 .. _google-sign-in/configuration:

content/applications/general/calendars.rst

@@ -1,11 +0,0 @@
-:nosearch:
-
-=========
-Calendars
-=========
-
-.. toctree::
-   :titlesonly:
-
-   calendars/outlook/outlook_calendar
-   calendars/google/google_calendar_credentials

content/applications/productivity.rst

@@ -8,6 +8,7 @@ Productivity
 .. toctree::
 
     productivity/discuss
+    productivity/calendar
     productivity/knowledge
     productivity/iot
     productivity/mail_plugins

content/applications/productivity/calendar.rst

@@ -0,0 +1,11 @@
+:nosearch:
+
+========
+Calendar
+========
+
+.. toctree::
+   :titlesonly:
+
+   calendar/outlook
+   calendar/google

content/applications/productivity/calendar/google.rst

@@ -1,6 +1,6 @@
-=====================================
-Synchronize Google Calendar with Odoo
-=====================================
+===============================
+Google Calendar synchronization
+===============================
 
 Synchronize Google Calendar with Odoo to see and manage meetings from both platforms (updates go
 in both directions). This integration helps organize your schedule so you never miss a meeting.
@@ -25,7 +25,7 @@ Begin by creating a new Google API project and enabling the Google Calendar API.
 
 Next, click :guilabel:`Select a project` and select or create an API project to store credentials.
 
-.. image:: google_calendar_credentials/new-api-project.png
+.. image:: google/new-api-project.png
    :align: center
    :alt: Create a new API project to store credentials.
 
@@ -34,14 +34,14 @@ Next, click :guilabel:`Select a project` and select or create an API project to
 
 Then, open the API Project and click :guilabel:`Enable APIs and Services`.
 
-.. image:: google_calendar_credentials/enable-apis-services.png
+.. image:: google/enable-apis-services.png
    :align: center
    :alt: Enable APIs and Services on the API Project.
 
 After that, search for *Google Calendar API* using the search bar and select :guilabel:`Google
 Calendar API` from the search results. Click :guilabel:`Enable`.
 
-.. image:: google_calendar_credentials/enable-google-cal-api.png
+.. image:: google/enable-google-cal-api.png
    :align: center
    :alt: Enable the Google Calendar API.
 
@@ -55,7 +55,7 @@ four steps to create your API credentials.
 - In the first step, :guilabel:`Credential Type`, select the :guilabel:`Google Calendar API` and
   :guilabel:`User Data` options. Then, click :guilabel:`Next`.
 
-.. image:: google_calendar_credentials/credential-type.png
+.. image:: google/credential-type.png
    :align: center
    :alt: Select Google Calendar API and User Data for the Credential Type.
 
@@ -76,7 +76,7 @@ four steps to create your API credentials.
     your company's Odoo URL address followed by */google_account/authentication*. Finally, click
     :guilabel:`Create` and :guilabel:`Done`.
 
-.. image:: google_calendar_credentials/uri.png
+.. image:: google/uri.png
    :align: center
    :alt: Add the authorized JavaScript origins and the authorized redirect URIs.
 
@@ -94,7 +94,7 @@ Next, locate the credentials you just created for the Google Calendar API. Then,
 :guilabel:`Edit OAuth Client` (the pencil icon). The page will redirect to the edit page, where you
 can view the Client ID and the Client Secret.
 
-.. image:: google_calendar_credentials/edit-oauth-2.png
+.. image:: google/edit-oauth-2.png
    :align: center
    :alt: Click Edit OAuth Client to view the credential details.
 
@@ -105,7 +105,7 @@ Once the Client ID and the Client Secret are located, open the Odoo database and
 :menuselection:`Settings --> General Settings --> Integrations --> Google Calendar`. Check the box
 next to :guilabel:`Google Calendar`.
 
-.. image:: google_calendar_credentials/settings-google-cal.png
+.. image:: google/settings-google-cal.png
    :align: center
    :alt: The Google Calendar checkbox in General Settings.
 
@@ -116,7 +116,7 @@ page into their respective fields below the :guilabel:`Google Calendar` checkbox
 Finally, open the Calendar module in Odoo and click on the :guilabel:`Google` sync button to sync
 Google Calendar with Odoo.
 
-.. image:: google_calendar_credentials/sync-google.png
+.. image:: google/sync-google.png
    :align: center
    :alt: Click the Google sync button in Odoo Calendar to sync Google Calendar with Odoo.
 
@@ -124,12 +124,12 @@ Google Calendar with Odoo.
    The first time you sync your Google Calendar with Odoo, the page will redirect to your Google
    Account. Click :guilabel:`OK` and :guilabel:`Allow` to authorize Odoo to access Google Calendar.
 
-.. image:: google_calendar_credentials/trust-odoo.png
+.. image:: google/trust-odoo.png
    :align: center
    :alt: Give Odoo permission to access Google Calendar.
 
 Now, Odoo Calendar is successfully synced with Google Calendar!
 
-.. image:: google_calendar_credentials/successful-sync.png
+.. image:: google/successful-sync.png
    :align: center
    :alt: Successfully sync between Odoo and Google Calendar.

content/applications/productivity/calendar/outlook.rst

@@ -1,6 +1,6 @@
-======================================
-Synchronize Outlook Calendar with Odoo
-======================================
+================================
+Outlook Calendar synchronization
+================================
 
 Synchronizing a user's Outlook Calendar with Odoo is useful for keeping track of their tasks and
 appointments across all related applications.
@@ -33,7 +33,7 @@ URI (URL) followed by `/microsoft_account/authentication`.
    Enter `https://www.companyname.odoo.com/microsoft_account/authentication` for the
    :guilabel:`Redirect URI`.
 
-.. image:: outlook_calendar/azure-register-application.png
+.. image:: outlook/azure-register-application.png
    :align: center
    :alt: The "Supported account type" and "Redirect URI" settings in the Microsoft Azure AD portal.
 
@@ -58,27 +58,27 @@ Configuration in Odoo
 In the Odoo database, go to :menuselection:`Settings --> General Settings --> Integrations` and
 activate the :guilabel:`Outlook Calendar` setting.
 
-.. image:: outlook_calendar/outlook-calendar-setting.png
+.. image:: outlook/outlook-calendar-setting.png
    :align: center
    :alt: The "Outlook Calendar" setting activated in Odoo.
 
 From the Microsoft Azure portal, under the :guilabel:`Overview` section of the application, copy
 the :guilabel:`Application (Client) ID`, and paste it into the :guilabel:`Client ID` field in Odoo.
 
-.. image:: outlook_calendar/client-id.png
+.. image:: outlook/client-id.png
    :align: center
    :alt: The "Client ID" in the Microsoft Azure portal.
 
 In the Microsoft Azure portal, under the :guilabel:`Certificates & secrets` section, copy the
 :guilabel:`Client Secret Value` and paste it into the :guilabel:`Client Secret` field in Odoo.
 
-.. image:: outlook_calendar/client-secret-value.png
+.. image:: outlook/client-secret-value.png
    :align: center
    :alt: The "Client Secret" token to be copied from Microsoft to Odoo.
 
 Finally, on the Odoo :menuselection:`Settings --> General Settings` page, click :guilabel:`Save`.
 
-.. _outlook_calendar/sync_with_outlook:
+.. _outlook/sync:
 
 Sync with Outlook
 =================
@@ -125,7 +125,7 @@ In the Odoo database, go to the :guilabel:`Calendar` module and click the :guila
 button. The page will redirect to a Microsoft login page, and the user is asked to log in to
 their account, if they are not already, and grant the required permissions.
 
-.. image:: outlook_calendar/outlook-sync-button.png
+.. image:: outlook/outlook-sync-button.png
    :align: center
    :alt: The "Outlook" sync button in Odoo Calendar.
 
@@ -134,11 +134,11 @@ The synchronization is a two-way process, meaning that events are reconciled in
 
 .. note::
    All users that want to use the synchronization simply need to :ref:`sync their calendar with
-   Outlook <outlook_calendar/sync_with_outlook>`. The configuration of Microsoft's Azure account
+   Outlook <outlook/sync>`. The configuration of Microsoft's Azure account
    is only done once, as Azure AD tenants' Client IDs and Client Secrets are unique, and represent
    an organization that helps the user to manage a specific instance of Microsoft cloud services
    for their internal and external users.
 
 .. seealso::
-   - :doc:`../../../productivity/mail_plugins/outlook`
-   - :doc:`../google/google_calendar_credentials`
+   - :doc:`../mail_plugins/outlook`
+   - :doc:`google`

redirects/14.0.txt

@@ -35,6 +35,11 @@ applications/finance/accounting/fiscal_localizations/overview/localizations_list
 applications/finance/accounting/getting_started/memento.rst applications/finance/accounting/getting_started/cheat_sheet.rst                        # memento -> cheat_sheet
 applications/finance/accounting/payables/supplier_bills/manage.rst applications/inventory_and_mrp/purchase/manage_deals/manage.rst # (#3302)
 
+# applications/general
+
+applications/general/calendars/outlook/outlook_calendar.rst applications/productivity/calendar/outlook.rst           # general/calendars/outlook/outlook_calendar -> productivity/calendar/outlook
+applications/general/calendars/google/google_calendar_credentials.rst applications/productivity/calendar/google.rst  # general/calendars/google/google_calendar_credentials -> productivity/calendar/google
+
 # applications/inventory
 
 applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse.rst applications/inventory_and_mrp/inventory/management/warehouses/warehouse_replenishment_transfer.rst