AAP-52256-B updated automation dashboard guide (#4273)

Author: emurtoug

downstream/titles/automation-dashboard/automation-dashboard/automation-dashboard/con-filter-automation-data.adoc

@@ -12,8 +12,7 @@ You can select one or more of the following options to customize your report:
 * **Template:** Select one or more Job Templates.
 * **Organization:** Select one or more Organizations.
 * **Project:** Select one or more Projects.
-* **Label:** Select one or more automations by label. Labels must be preconfigured and assigned to {PlatformNameShort} before they display in {AutomationDashboardName}. For more on configuring labels, see the _Creating a job template_ procedure.
-//emurtoug update the link to Creating Job Templates procedure
+* **Label:** Select one or more automations by label. Labels must be preconfigured and assigned to {PlatformNameShort} before they display in {AutomationDashboardName}. For more on configuring labels, see link:https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/{PlatformVers}/html/using_automation_execution/controller-job-templates#controller-create-job-template[Creating a job template].
 
 == Time period and currency
 
@@ -26,4 +25,4 @@ Changing from one currency to another does not convert the value. You must manua
 
 == Save a report
 
-Use *Save as report* to save this report to your {AutomationDashboardName}. You can retrieve it at any time by using *Select a report*.
+Use *Save as Report* to save this report to your {AutomationDashboardName}. You can retrieve it at any time by using *Select a Report*.

downstream/titles/automation-dashboard/automation-dashboard/automation-dashboard/proc-analyzing-costs-savings.adoc

@@ -9,8 +9,10 @@ To calculate your savings, use the following procedure:
 
 .Procedure
 
-. Use the **Average cost of an employee minut**e field to enter the average cost per minute for an engineer to manually run jobs.
-. Use the **Cost per minute of {PlatformNameShort}** field to enter an average cost per minute of running a job using {PlatformNameShort}. You can include the costs associated with creating the initial or ongoing automation execution.
+. Use the **Average cost per minute to manually run the job** field to enter the average cost per minute for an engineer to manually run jobs.
+. Use the **Average cost per minute of running on {PlatformNameShort}** field to enter an average cost per minute of running a job using {PlatformNameShort}. You can include the costs associated with creating the initial or ongoing automation execution.
+. Select **Time taken to create automation into calculation** to include the costs associated with creating the initial or ongoing automation execution.
+
 Based on these inputs, {AutomationDashboardName} provides the following data: 
 
 
@@ -19,6 +21,8 @@ Based on these inputs, {AutomationDashboardName} provides the following data:
 * **Total savings/cost avoided**: This is the difference between the **Cost of manual automation** and the **Cost of automated execution**. This is a key metric for demonstrating the return on investment attainable by using {PlatformNameShort}.
 * **Total hours saved/avoided**: This figure is calculated by adding host executions and automation creation time, then subtracting the running time in minutes.
 * **Time taken to manually execute (min)**: This metric represents the amount of time it would take for a user to perform the task manually on a host. It is an input provided to compare the value of manual execution and automated execution using the time taken by the organization to manually automate. 
-
++
 [NOTE]
-You can export the data from your cost and savings analysis as a CSV.
+====
+You can export the data from your cost and savings analysis as a CSV.
+====

downstream/titles/automation-dashboard/automation-dashboard/automation-dashboard/proc-installing-automation-dashboard.adoc

@@ -125,7 +125,5 @@ ec2-54-147-26-173.compute-1.amazonaws.com : ok=126  changed=51   unreachable=0
 localhost              : ok=12  changed=0    unreachable=0    failed=0    skipped=9    rescued=0    ignored=0
 ----
 
-.Troubleshooting
-
-* Alternative configurations are possible (for example, the database for {AutomationDashboardName} can be set on a different host). This requires additional changes to variables in the inventory file.
-* Consult the section “Inventory variables” below for available variables.
+Alternative configurations are possible (for example, the database for {AutomationDashboardName} can be set on a different host). This requires additional changes to variables in the inventory file. For more information, see the Inventory variables section of this guide
+//emurtoug note to add link to appendix

downstream/titles/automation-dashboard/automation-dashboard/automation-dashboard/proc-integrating-automation-dashboard.adoc

@@ -11,16 +11,21 @@ Integrate your {PlatformNameShort} instances into the {AutomationDashboardName}
 .Procedure 
 
 . Verify that {AutomationDashboardName} is running on https port 8447 on your RHEL host. This verification will require your login details as defined in the inventory file. 
-[NOTE] 
-Port 8447 is enabled by default, but this is configurable. 
++
+[NOTE]
+====
+Port 8447 is enabled by default, but this is configurable.
+====
 . Enter `admin` as the username and use `reporter_admin_password` as the password.
 . Your {PlatformNameShort} instances are added into `clusters.yml` using the following information:
 * Your {PlatformNameShort} URLs/ports for front-end access
 * A preconfigured {PlatformNameShort} 0Auth token for read access
-[NOTE] 
++
+[NOTE]
+====
 If you don’t have access to {PlatformNameShort}, consult your administrator.
-. Configure a personal access token. For more information, see Configuring access to external applications with token-based authentication.
-//emurtoug reminder to add link for Configuring access to external apps
+====
+. Configure a personal access token. For more information, see link:https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/{PlatformVers}/html/access_management_and_authentication/gw-token-based-authentication[Configuring access to external applications with token-based authentication].
 . After you have configured your access token, run the following command:
 +
 [source,bash]
@@ -30,8 +35,11 @@ vi clusters.yml
 ----
 
 . You can add one or more {PlatformNameShort} instances into the {AutomationDashboardName} configuration for pulling and combining data by using the following: 
-[NOTE] 
++
+[NOTE]
+====
 If you only have one {PlatformNameShort} instance, then remove the second entry.
+====
 +
 [source,bash]
 ----

downstream/titles/automation-dashboard/automation-dashboard/automation-dashboard/proc-uninstalling-automation-dashboard.adoc

@@ -10,7 +10,7 @@ This procedure describes how to uninstall {AutomationDashboardName} by running a
 
 .Procedure
 
-Run the following command to uninstall {AutomationDashboardName} and its dependencies, including the PostgreSQL database container:
+. Run the following command to uninstall {AutomationDashboardName} and its dependencies, including the PostgreSQL database container:
 +
 [source,bash,subs="+attributes"]
 ----