Editing controller files for DITA (ansible#3864)

Configuring automation execution modular compliance chapter 7

https://issues.redhat.com/browse/AAP-46724

Affects `titles/controller-admin-guide`

Author: EMcWhinn

downstream/assemblies/platform/assembly-controller-pac.adoc

@@ -18,7 +18,7 @@ Policy enforcement at automation runtime is a feature that uses encoded rules to
 
 OPA, or link:https://www.openpolicyagent.org/docs/latest/[Open Policy Agent], is a policy engine that offloads policy decisions from your Ansible instance. When it is triggered, the policy enforcement feature connects to OPA to retrieve policies specified in your configuration, and applies policy rules to your automation content. If OPA detects a policy violation, it will stop the action and give your user information about the policy violation.
 
-.Prerequisites
+*Prerequisites*
 
 Before you can implement policy enforcement in your {PlatformNameShort} instance, you must have: 
 
@@ -27,7 +27,8 @@ Before you can implement policy enforcement in your {PlatformNameShort} instance
 * Configured {PlatformNameShort} with settings required for authenticating to your OPA server.
 * Some familiarity with OPA and the Rego language, which is the language policies are written in.
 
-For policy enforcement to work correctly, you must both configure the OPA server in your policy settings, and associate a specific policy with a particular resource (for example, a particular organization, inventory, or job template). 
+For policy enforcement to work correctly, you must both configure the OPA server in your policy settings, and associate a specific policy with a particular resource.
+For example, a particular organization, inventory, or job template. 
 
 [NOTE]
 ====
@@ -49,4 +50,3 @@ include::platform/proc-pac-add-policy-to-inventory.adoc[leveloffset=+2]
 include::platform/proc-pac-add-policy-to-template.adoc[leveloffset=+2]
 
 include::platform/ref-pac-inputs-outputs.adoc[leveloffset=+1]
-

downstream/modules/platform/proc-configure-pac-settings.adoc

@@ -30,7 +30,7 @@ OPA custom authentication header:: Enter a custom header to append to request he
 OPA request timeout:: Enter the number of seconds until the connection times out.
 OPA request retry count:: Enter a figure for the number of times a request can attempt to connect to the OPA service before failing.
 +
-. Depending on your authentication type, you may need to fill out the following fields.
+. Depending on your authentication type, you might need to fill out the following fields.
 .. If you selected Token as your authentication type:
 +
 OPA authentication token:: Enter the OPA authentication token.
@@ -43,4 +43,4 @@ OPA CA certificate content:: Enter the content of the CA certificate for mTLS au
 +
 . Beneath the heading labeled *Options*:
 Use SSL for OPA connection:: Check this box to enable an SSL connection to the OPA service.
-. Click btn:[Save policy settings].
+. Click btn:[Save policy settings].

downstream/modules/platform/ref-pac-inputs-outputs.adoc

@@ -114,7 +114,7 @@ Information about the user who launched the job, including:
 
 * `id` (integer): the user's unique identifier
 * `name` (string): the user name
-* `type` (type): the user type (for example, `user`, `system`, etc)
+* `type` (type): the user type (for example, `user` or `system`)
 * `url` (string): the user's API URL
 |`organization`|Object
 a|
@@ -146,7 +146,6 @@ Details about the project associated with the job, including:
 |`workflow_job_template`|Object|Workflow job template details.
 |====
 
-.Example
 The following code block shows example input data from a demo job template launch:
 [source,rego]
 ----
@@ -272,7 +271,6 @@ The following code block shows example input data from a demo job template launc
 |`violations`|List of strings|Reasons why the action is not permitted
 |====
 
-.Example
 The following code block shows an example of expected output from the OPA policy query:
 [source,rego]
 ----
@@ -284,4 +282,4 @@ The following code block shows an example of expected output from the OPA policy
   ],
   ...
 }
-----
+----