RHIDP-7202: Apply SME comments

Author: linfraze

assemblies/assembly-configuring-techdocs.adoc

@@ -22,6 +22,9 @@ After you configure {odf-name} to store the files that TechDocs generates, you c
 //configuring storage
 include::modules/customizing-techdocs/con-techdocs-configure-storage.adoc[leveloffset=+1]
 
+//configuring storage - Amazon S3
+include::modules/techdocs/proc-techdocs-configure-amazon-s3-storage.adoc[leveloffset=+2]
+
 //configuring storage - ODF
 include::modules/customizing-techdocs/proc-techdocs-using-odf-storage.adoc[leveloffset=+2]
 
@@ -33,14 +36,6 @@ include::modules/customizing-techdocs/proc-techdocs-configure-odf-operator.adoc[
 
 include::modules/customizing-techdocs/ref-techdocs-example-config-plugin-operator.adoc[leveloffset=+4]
 
-//configuring storage - Amazon S3
-include::modules/techdocs/proc-techdocs-configure-amazon-s3-storage.adoc[leveloffset=+2]
-
 //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/con-techdocs-configure-storage.adoc

@@ -2,4 +2,4 @@
 [id="con-techdocs-configure-storage_{context}"]
 = Configuring storage for TechDocs files
 
-The TechDocs publisher stores generated files in local storage or in cloud storage, such as {odf-name}, Google GCS, AWS S3, or Azure Blob Storage.
+The TechDocs publisher stores generated files in local storage or in cloud storage, such as AWS S3 or {odf-name}.

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,15 +51,19 @@ 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]
 ====
 You can use the newly created access keys to generate a TechDocs pipeline with GitHub Actions.
 ====
+. From the {ocp-short} web console, click *Topology* > *Actions* > *Restart rollout* to restart the pod.
++
+[NOTE]
+====
+You must restart the pod to apply the configuration changes.
+====
 
 .Verification
 . Go to your Amazon S3 bucket to see a set of static site files in your *Objects* list.

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:
@@ -37,7 +42,7 @@ _<frame_border>_ :: Specifies the size of the frame border in number of pixels,
 ====
 TechDocs uses DOMPurify to sanitize HTML. To prevent DOMPurify from removing the `<iframe>` elements, you must list every permitted video host, such as www.youtube.com, under the `techdocs.sanitizer.allowedIframeHosts` section of your `app-config.yaml` file. You must also add the video host to the `backend.csp` section of your `app-config.yaml` file.
 ====
-. In the `frame-src` and `allowedIframeHosts` fields of your `app-config.yaml` file, add any video hosts that you want to use. For example:
+. In the `frame-src` and `allowedIframeHosts` fields of your `app-config.yaml` file, add any video hosts that you want to use. You can add multiple. hosts. For example:
 +
 [source,yaml,subs="+quotes,+attributes"]
 ----
@@ -50,21 +55,11 @@ techdocs:
   sanitizer:
     allowedIframeHosts:
       - www.youtube.com
+      - _<additional_video_host_url>_
   publisher:
     type: awsS3
     awsS3:
       bucketName: ${AWS_S3_BUCKET_NAME}
       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}
-----