[REF] marketing automation: move getting started

closes odoo/documentation#7658

Signed-off-by: Zachary Straub (zst) <zst@odoo.com>

content/applications/marketing/marketing_automation.rst

@@ -1,17 +1,126 @@
-:nosearch:
 :show-content:
 :hide-page-toc:
-:show-toc:
 
 ====================
 Marketing Automation
 ====================
 
+The Odoo *Marketing Automation* app automates a variety of marketing tasks by combining specific
+rules and filters to generate timed actions. Instead of manually having to build each stage of a
+campaign (like a series of timed massmails), the *Marketing Automation* app allows marketers to
+build the entire campaign, and all of its stages, in one place---on one dashboard.
+
 .. seealso::
-   - `Odoo Tutorials: Marketing <https://www.odoo.com/slides/marketing-27>`_
+   `Odoo Tutorials: Marketing <https://www.odoo.com/slides/marketing-27>`_
+
+Campaign configuration
+======================
+
+To create a new automated marketing campaign, navigate to :menuselection:`Marketing Automation app
+--> New` to reveal a blank campaign form.
+
+.. image:: marketing_automation/blank-marketing-campaign-form.png
+   :align: center
+   :alt: A blank marketing automation campaign form in Odoo Marketing Automation application.
+
+After entering a name for the marketing campaign, configure the target audience in the remaining
+fields.
+
+A target audience can be configured by entering specific criteria for Odoo to use when determining
+to whom this marketing automation campaign should be sent.
+
+In the :guilabel:`Target` field, use the drop-down menu to choose which model the target audience
+filters should be based on (e.g. :guilabel:`Contact`, :guilabel:`Lead/Opportunity`,
+:guilabel:`Sales Order`, etc.).
+
+Select :guilabel:`Search More...` from the drop-down menu to reveal a :guilabel:`Search: Target`
+pop-up window containing all of the available targeting options.
+
+Once a :guilabel:`Target` is selected, there's a :guilabel:`Unicity based on` field. This field is
+used to avoid duplicates based on the model chosen in the :guilabel:`Target` field.
+
+.. example::
+   If :guilabel:`Customers` is chosen as the :guilabel:`Target`, select :guilabel:`Email` in the
+   :guilabel:`Unicity based on` field so Odoo only processes one record for each customer email
+   address.
+
+Select :guilabel:`Search More...` from the :guilabel:`Unicity based on` drop-down menu to reveal all
+available options in a pop-up window.
+
+Last on the campaign form is the :guilabel:`Filter` field. This is where more specific targeting
+options can be layered into the campaign to further narrow the number and type of recipients that
+receive the marketing automation material.
+
+If left alone, the :guilabel:`Filter` field reads: :guilabel:`Match all records`. That means Odoo
+uses the :guilabel:`Target` and :guilabel:`Unicity based on` fields to determine who the recipients
+will be. The number of recipients is represented beneath as :guilabel:`record(s)`.
+
+Campaign filter rules
+---------------------
+
+To add a more specific filter to a marketing automation campaign, click the :guilabel:`Add
+condition` button in the :guilabel:`Filter` field. Doing so reveals a series of other configurable
+filter rule fields.
+
+In the rule fields, customizable equations can be configured for Odoo to use when filtering who to
+include or exclude in this specific marketing campaign.
+
+.. image:: marketing_automation/filter-node-equation-fields.png
+   :align: center
+   :alt: How the filter rule equation fields look in Odoo Marketing Automation campaigns.
+
+.. note::
+   :guilabel:`Records` refer to contacts in the system that fit the specified criteria for a
+   campaign.
+
+Also, once :guilabel:`Add condition` is clicked, the ability to :guilabel:`Save as Favorite Filter`
+becomes available on the campaign form.
+
+There is also the option to match records with :guilabel:`all` or :guilabel:`any` of the rules
+configured in the :guilabel:`Filter` field.
+
+To choose either of those options, click :guilabel:`all` from the middle of the sentence
+":guilabel:`Match records with all of the following rules`" to reveal a drop-down menu with those
+options.
+
+.. image:: marketing_automation/match-all-any-rules-drop-down.png
+   :align: center
+   :alt: Match records with all or any of the rules in Filter field for marketing campaigns.
+
+When the first field of the rule equation is clicked, a nested drop-down menu of options appears on
+the screen where specific criteria is chosen based on needs of the campaign.
+
+The remaining fields on the rule equation further define the criteria, which is used to determine
+which records in the database to include or exclude in the execution of the campaign.
+
+To add another rule, either click the :guilabel:`➕ (plus sign)` icon to the right of the filtering
+rule, or click :guilabel:`New Rule` beneath the rule equation fields. When either are clicked, a new
+series of rule fields appears.
+
+To add a branch of multiple rules at the same time, click the :guilabel:`branch` icon, located to
+the right of the :guilabel:`➕ (plus sign)` icon. When clicked, two additional sub-rule equation
+fields appear beneath the initial rule.
+
+.. image:: marketing_automation/rule-branch-filter-sample.png
+   :align: center
+   :alt: Sample of how the rule branches look in the filter section of a marketing campaign.
+
+There is also the option to have the filter apply to :guilabel:`any` or :guilabel:`all` of the
+configured branch rules.
+
+For further information on marketing automation campaign filter configuration, refer to the
+:doc:`marketing_automation/target_audience` documentation.
+
+.. seealso::
+   - :doc:`marketing_automation/target_audience`
+   - :doc:`marketing_automation/workflow_activities`
+   - :doc:`marketing_automation/testing_running`
+   - :doc:`marketing_automation/understanding_metrics`
 
 .. toctree::
    :titlesonly:
 
-   marketing_automation/getting_started
-   marketing_automation/advanced
+   marketing_automation/target_audience
+   marketing_automation/workflow_activities
+   marketing_automation/testing_running
+   marketing_automation/understanding_metrics

content/applications/marketing/marketing_automation/advanced.rst

@@ -1,10 +0,0 @@
-:nosearch:
-
-========
-Advanced
-========
-
-.. toctree::
-   :titlesonly:
-
-   advanced/understanding_metrics

content/applications/marketing/marketing_automation/getting_started.rst

@@ -1,13 +0,0 @@
-:nosearch:
-
-===============
-Getting Started
-===============
-
-.. toctree::
-   :titlesonly:
-
-   getting_started/first_campaign
-   getting_started/target_audience
-   getting_started/workflow_activities
-   getting_started/testing_running

content/applications/marketing/marketing_automation/getting_started/first_campaign.rst

@@ -1,110 +0,0 @@
-==============================
-Marketing automation campaigns
-==============================
-
-The Odoo *Marketing Automation* app automates a variety of marketing tasks by combining specific
-rules and filters to generate timed actions. Instead of manually having to build each stage of a
-campaign (like a series of timed massmails), the *Marketing Automation* app allows marketers to
-build the entire campaign, and all of its stages, in one place---on one dashboard.
-
-Campaign configuration
-======================
-
-To create a new automated marketing campaign, navigate to :menuselection:`Marketing Automation app
---> New` to reveal a blank campaign form.
-
-.. image:: first_campaign/blank-marketing-campaign-form.png
-   :align: center
-   :alt: A blank marketing automation campaign form in Odoo Marketing Automation application.
-
-After entering a name for the marketing campaign, configure the target audience in the remaining
-fields.
-
-A target audience can be configured by entering specific criteria for Odoo to use when determining
-to whom this marketing automation campaign should be sent.
-
-In the :guilabel:`Target` field, use the drop-down menu to choose which model the target audience
-filters should be based on (e.g. :guilabel:`Contact`, :guilabel:`Lead/Opportunity`,
-:guilabel:`Sales Order`, etc.).
-
-Select :guilabel:`Search More...` from the drop-down menu to reveal a :guilabel:`Search: Target`
-pop-up window containing all of the available targeting options.
-
-Once a :guilabel:`Target` is selected, there's a :guilabel:`Unicity based on` field. This field is
-used to avoid duplicates based on the model chosen in the :guilabel:`Target` field.
-
-.. example::
-   If :guilabel:`Customers` is chosen as the :guilabel:`Target`, select :guilabel:`Email` in the
-   :guilabel:`Unicity based on` field so Odoo only processes one record for each customer email
-   address.
-
-Select :guilabel:`Search More...` from the :guilabel:`Unicity based on` drop-down menu to reveal all
-available options in a pop-up window.
-
-Last on the campaign form is the :guilabel:`Filter` field. This is where more specific targeting
-options can be layered into the campaign to further narrow the number and type of recipients that
-receive the marketing automation material.
-
-If left alone, the :guilabel:`Filter` field reads: :guilabel:`Match all records`. That means Odoo
-uses the :guilabel:`Target` and :guilabel:`Unicity based on` fields to determine who the recipients
-will be. The number of recipients is represented beneath as :guilabel:`record(s)`.
-
-Campaign filter rules
----------------------
-
-To add a more specific filter to a marketing automation campaign, click the :guilabel:`Add
-condition` button in the :guilabel:`Filter` field. Doing so reveals a series of other configurable
-filter rule fields.
-
-In the rule fields, customizable equations can be configured for Odoo to use when filtering who to
-include or exclude in this specific marketing campaign.
-
-.. image:: first_campaign/filter-node-equation-fields.png
-   :align: center
-   :alt: How the filter rule equation fields look in Odoo Marketing Automation campaigns.
-
-.. note::
-   :guilabel:`Records` refer to contacts in the system that fit the specified criteria for a
-   campaign.
-
-Also, once :guilabel:`Add condition` is clicked, the ability to :guilabel:`Save as Favorite Filter`
-becomes available on the campaign form.
-
-There is also the option to match records with :guilabel:`all` or :guilabel:`any` of the rules
-configured in the :guilabel:`Filter` field.
-
-To choose either of those options, click :guilabel:`all` from the middle of the sentence
-":guilabel:`Match records with all of the following rules`" to reveal a drop-down menu with those
-options.
-
-.. image:: first_campaign/match-all-any-rules-drop-down.png
-   :align: center
-   :alt: Match records with all or any of the rules in Filter field for marketing campaigns.
-
-When the first field of the rule equation is clicked, a nested drop-down menu of options appears on
-the screen where specific criteria is chosen based on needs of the campaign.
-
-The remaining fields on the rule equation further define the criteria, which is used to determine
-which records in the database to include or exclude in the execution of the campaign.
-
-To add another rule, either click the :guilabel:`➕ (plus sign)` icon to the right of the filtering
-rule, or click :guilabel:`New Rule` beneath the rule equation fields. When either are clicked, a new
-series of rule fields appears.
-
-To add a branch of multiple rules at the same time, click the :guilabel:`branch` icon, located to
-the right of the :guilabel:`➕ (plus sign)` icon. When clicked, two additional sub-rule equation
-fields appear beneath the initial rule.
-
-.. image:: first_campaign/rule-branch-filter-sample.png
-   :align: center
-   :alt: Sample of how the rule branches look in the filter section of a marketing campaign.
-
-There is also the option to have the filter apply to :guilabel:`any` or :guilabel:`all` of the
-configured branch rules.
-
-For further information on marketing automation campaign filter configuration, refer to :doc:`this
-documentation page <target_audience>`.
-
-.. seealso::
-   - :doc:`workflow_activities`
-   - :doc:`testing_running`

content/applications/marketing/marketing_automation/testing_running.rst

@@ -13,8 +13,8 @@ To test a marketing campaign, open the :menuselection:`Marketing Automation app`
 desired campaign to test, which reveals the campaign's detail form.
 
 On the campaign detail form, make sure the campaign already has activities configured in the
-workflow (or build a campaign by following the directions on :doc:`this documentation
-</applications/marketing/marketing_automation/getting_started/workflow_activities>`).
+workflow (or build a campaign by following the directions on :doc:`workflow_activities`
+documentation).
 
 .. note::
    Testing marketing automation campaigns is meant to be performed in the production version of the
@@ -148,6 +148,6 @@ the upper-right corner of the campaign detail form.
    :alt: Marketing campaign's stopped status on a campaign detail form in Odoo Marketing Automation.
 
 .. seealso::
-   - :doc:`first_campaign`
+   - :doc:`Campaign configuration <../marketing_automation>`
    - :doc:`target_audience`
    - :doc:`workflow_activities`

content/applications/marketing/marketing_automation/understanding_metrics.rst

@@ -18,10 +18,9 @@ that have been :guilabel:`Clicked`, and more.
    :align: center
    :alt: An activity block in the workflow section with useful analytical data in Odoo.
 
-To the left of the activity block, the configured :doc:`trigger time
-<../getting_started/workflow_activities>` is displayed as a duration (either :guilabel:`Hours`,
-:guilabel:`Days`, :guilabel:`Weeks`, or :guilabel:`Months`) if it corresponds to period after the
-workflow begins.
+To the left of the activity block, the configured :doc:`trigger time <workflow_activities>` is
+displayed as a duration (either :guilabel:`Hours`, :guilabel:`Days`, :guilabel:`Weeks`, or
+:guilabel:`Months`) if it corresponds to period after the workflow begins.
 
 .. note::
    If the trigger time is dependent on another activity or triggering action (e.g. :guilabel:`Mail:
@@ -48,7 +47,7 @@ activity, in which that activity can be modified. Click the :guilabel:`Delete` b
 delete that specific activity from the workflow.
 
 .. seealso::
-   :doc:`/applications/marketing/marketing_automation/getting_started/workflow_activities`
+   :doc:`workflow_activities`
 
 Activity graph tab
 ------------------

redirects/17.0.txt

@@ -11,3 +11,13 @@ applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_
 applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/least_packages.rst applications/inventory_and_mrp/inventory/warehouses_storage/removal_strategies/least_packages.rst       # advanced_operations_warehouse/* --> removal_strategies/*
 applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/lifo.rst applications/inventory_and_mrp/inventory/warehouses_storage/removal_strategies/lifo.rst                           # advanced_operations_warehouse/* --> removal_strategies/*
 applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/removal.rst applications/inventory_and_mrp/inventory/warehouses_storage/removal_strategies.rst                             # advanced_operations_warehouse/removal --> warehouses_storage/removal_strategies
+
+# applications/marketing
+
+applications/marketing/marketing_automation/getting_started.rst applications/marketing/marketing_automation.rst                                           # getting_started --> marketing_automation
+applications/marketing/marketing_automation/advanced.rst applications/marketing/marketing_automation.rst                                                  # advanced --> marketing_automation
+applications/marketing/marketing_automation/advanced/understanding_metrics.rst applications/marketing/marketing_automation/understanding_metrics.rst      # advanced/* --> marketing_automation/*
+applications/marketing/marketing_automation/getting_started/first_campaign.rst applications/marketing/marketing_automation.rst                            # getting_started/first_campaign --> marketing_automation
+applications/marketing/marketing_automation/getting_started/target_audience.rst applications/marketing/marketing_automation/target_audience.rst           # getting_started/* --> marketing_automation/*
+applications/marketing/marketing_automation/getting_started/testing_running.rst applications/marketing/marketing_automation/testing_running.rst           # getting_started/* --> marketing_automation/*
+applications/marketing/marketing_automation/getting_started/workflow_activities.rst applications/marketing/marketing_automation/workflow_activities.rst   # getting_started/* --> marketing_automation/*