RHIDP-7202: Apply SME comments

Author: linfraze

assemblies/assembly-configuring-techdocs.adoc

@@ -39,8 +39,3 @@ include::modules/techdocs/proc-techdocs-configure-amazon-s3-storage.adoc[levelof
 //configuring CI/CD
 include::modules/customizing-techdocs/con-techdocs-config-cicd.adoc[leveloffset=+1]
 
-include::modules/customizing-techdocs/proc-techdocs-config-cicd-prep-repo.adoc[leveloffset=+2]
-
-include::modules/customizing-techdocs/proc-techdocs-generate-site.adoc[leveloffset=+2]
-
-include::modules/customizing-techdocs/proc-techdocs-publish-site.adoc[leveloffset=+2]

modules/customizing-techdocs/con-techdocs-config-cicd.adoc

@@ -1,3 +1,5 @@
+// ARCHIVED
+
 :_mod-docs-content-type: CONCEPT
 [id="con-techdocs-config-cicd_{context}"]
 = Configuring CI/CD to generate and publish TechDocs sites

modules/customizing-techdocs/proc-techdocs-config-cicd-prep-repo.adoc

@@ -1,3 +1,5 @@
+// ARCHIVED
+
 :_mod-docs-content-type: PROCEDURE
 [id="proc-techdocs-config-cicd-prep-repo_{context}"]
 = Preparing your repository for CI

modules/customizing-techdocs/proc-techdocs-generate-site.adoc

@@ -1,3 +1,5 @@
+// ARCHIVED
+
 :_mod-docs-content-type: PROCEDURE
 [id="proc-techdocs-generate-site_{context}"]
 = Generating the TechDocs site

modules/customizing-techdocs/proc-techdocs-publish-site.adoc

@@ -1,3 +1,5 @@
+// ARCHIVED
+
 :_mod-docs-content-type: PROCEDURE
 [id="proc-techdocs-publish-site_{context}"]
 = Publishing the TechDocs site

modules/techdocs/proc-techdocs-configure-amazon-s3-storage.adoc

@@ -11,6 +11,8 @@
 .Prerequisites
 
 * You are logged in to your AWS account.
+* You have sufficient permissions to create and configure the AWS S3 bucket
+and the IAM policy in the AWS console
 
 .Procedure
 . On the AWS console, create an AWS S3 bucket.
@@ -49,9 +51,7 @@ where
 _<bucket_name>_ :: Specifies the name of your Amazon S3 bucket.
 +
 .. On the *Create policy > Specify permissions* page, enter a *Policy name*.
-. Create a user and assign the IAM policy.
-.. On the *Create user > Specify user details* page, enter a *User name*.
-.. On the *Create user > Set permissions* page, select *Attach policies directly* and select the permissions policy that you created.
+. Assign the IAM policy to a new or existing user.
 . Generate a new access key and a new secret access key.
 +
 [NOTE]

modules/techdocs/proc-techdocs-embed-videos.adoc

@@ -8,6 +8,11 @@
 
 You can use `<iframe>` elements to embed videos into your TechDocs.
 
+.Prerequisites
+
+* An administrator has configured your AWS S3 bucket to store TechDocs sites.
+* An administrator has configured the appropriate `techdocs.sanitizer.allowedIframeHosts` and `backend.csp` settings in your `app-config.yaml` file.
+
 .Procedure
 
 . In the section of the TechDocs file that you want to embed a video into, add the following configuration:
@@ -57,14 +62,3 @@ techdocs:
       accountId: ${AWS_ACCOUNT_ID}
       region: ${AWS_REGION}
 ----
-+
-. To authenticate with AWS, add the following configuration to your `app-config.yaml` file. For example:
-+
-[source,yaml]
-----
-aws:
-  accounts:
-    - accountId: ${AWS_ACCOUNT_ID}
-      accessKeyId: ${AWS_ACCESS_KEY_ID}
-      secretAccessKey: ${AWS_SECRET_ACCESS_KEY}
-----