AAP-44847 Update self-service installation doc per user feedback

Author: ariordan-redhat

downstream/assemblies/devtools/assembly-self-service-generate-scm-tokens.adoc

@@ -12,11 +12,21 @@ ifdef::context[]
 [id="self-service-generate-scm-tokens_{context}"]
 endif::[]
 
+:context: self-service-generate-scm-tokens
+
 = Generating GitHub and Gitlab personal access tokens
 
-:context: self-service-generate-scm-tokens
+If you are planning to use private repositories, you must set up personal access tokens (PATs) in your SCM (Scource control management (SCM).
+
+[NOTE]
+====
+You must add a source control credential in your {PlatformNameShort} instance.
+See
+link:{URLSelfServiceUsing}/self-service-using-scm-credentials-private-repos_aap-self-service-using#self-service-add-scm-credentials-aap_self-service-using-scm-credentials-private-repos[Adding Source Control Credentials for GitHub or Gitlab in Ansible Automation Platform].
+====
 
 include::devtools/proc-self-service-create-gh-pat.adoc[leveloffset=+1]
+
 include::devtools/proc-self-service-create-gl-pat.adoc[leveloffset=+1]
 
 ifdef::parent-context-of-self-service-generate-scm-tokens[:context: {parent-context-of-self-service-generate-scm-tokens}]

downstream/modules/devtools/proc-self-service-download-tar.adoc

@@ -19,28 +19,15 @@ link:{PlatformDownloadUrl}[Red Hat Ansible Automation Platform Product Software
 The format of the filename is `ansible-backstage-rhaap-bundle-x.y.z.tar.gz`. 
 +
 Substitute the Ansible plug-ins release version, for example `1.0.0`, for `x.y.z`.
-. Extract the `ansible-backstage-rhaap-bundle-<version-number>.tar.gz` contents to `$DYNAMIC_PLUGIN_ROOT_DIR`.
+. Extract the {SelfServiceShort} plug-ins from `ansible-backstage-rhaap-bundle-<version-number>.tar.gz` to `$DYNAMIC_PLUGIN_ROOT_DIR`.
 +
 ----
-$ tar --exclude='*code*' -xzf ansible-backstage-rhaap-bundle-x.y.z.tar.gz -C $DYNAMIC_PLUGIN_ROOT_DIR
+$ tar -xzf ansible-backstage-rhaap-bundle-x.y.z.tar.gz -C $DYNAMIC_PLUGIN_ROOT_DIR 'ansible-backstage-plugin-*-dynamic-*.tgz*' 'ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-*.tgz*' 'ansible-plugin-backstage-self-service-dynamic-*.tgz*'
 ----
 +
 Substitute the Ansible plug-ins release version, for example `1.0.0`, for `x.y.z`.
 
 .Verification
 
-Run `ls` to verify that the extracted files are in the `$DYNAMIC_PLUGIN_ROOT_DIR` directory:
-
-----
-$ ls $DYNAMIC_PLUGIN_ROOT_DIR
-ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz
-ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz.integrity
-ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
-ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz.integrity
-ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
-ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz.integrity
-
-----
-
-The files with the `.integrity` file type contain the plugin SHA value.
+Run `ls` to verify that the extracted files are in the `$DYNAMIC_PLUGIN_ROOT_DIR` directory.
 

downstream/modules/devtools/proc-self-service-install-helm-from-catalog.adoc

@@ -14,7 +14,7 @@
 . Click the *Helm* option in the OpenShift sidebar.  
 . In the *Helm* page, click *Create* and select *Helm Release*. 
 . Search for `AAP` in the Helm Charts filter,
-and select the `AAP Technical Preview: Self-service automation` chart. 
+and select the `AAP Technology Preview: Self-service automation` chart. 
 . In the modal dialog on the chart page, click *Create*.
 . Select the *YAML view* in the *Create Helm Release* page.
 . Locate the `clusterRouterBase` key in the YAML file and replace the placeholder value with the base URL of your OpenShift instance.

downstream/modules/devtools/proc-self-service-setup-registry-image.adoc

@@ -36,12 +36,4 @@ image::self-service-plugin-registry.png[Developer perspective]
 (1) Plug-in registry
 . Click the *terminal* tab and log in to the container.
 . In the terminal, run `ls` to confirm that the `.tar` files are in the plugin registry.
-+
-----
-ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz
-ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
-ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
-----
-+
-The version numbers and file names can differ.