Merge pull request #110527 from dfitzmau/revert-OSDOCS-16842-16

Revert "OSDOCS-16842-16:  CQA for NOP-1 AWS Load Balancer Operator"

Author: dfitzmau

modules/aws-installing-an-aws-load-balancer-operator.adoc

@@ -5,9 +5,7 @@
 :_mod-docs-content-type: PROCEDURE
 [id="aws-installing-an-aws-load-balancer-operator_{context}"]
 = Installing an AWS Load Balancer Operator
-
-[role="_abstract"]
-To install the AWS Load Balancer Operator and the AWS Load Balancer Controller, ensure that your environment meets the necessary requirements. Meeting these prerequisites is essential for the successful deployment of the Operator and controller.
+You can install an AWS Load Balancer Operator (ALBO) if you meet certain requirements.
 
 .Prerequisites
 
@@ -83,13 +81,13 @@ ROSA
 endif::openshift-rosa[]
 cluster OIDC DNS:
 +
+--
 [source, terminal]
 ----
 $ rosa describe cluster --cluster=<cluster_name> | grep -i 'OIDC'
 ----
-+
 Save the output from the commands. You will use this information in future steps within this procedure.
-
+--
 . Create the AWS IAM policy required for the ALBO:
 +
 .. Log in to the
@@ -111,16 +109,9 @@ $ oc new-project aws-load-balancer-operator
 [source,terminal]
 ----
 $ IDP='{Cluster_OIDC_Endpoint}'
+$ IDP_ARN="arn:aws:iam::{AWS_AccountNo}:oidc-provider/${IDP}" <1>
 ----
-+
-[source,terminal]
-----
-$ IDP_ARN="arn:aws:iam::{AWS_AccountNo}:oidc-provider/${IDP}"
-----
-+
-where:
-+
-`AWS_AccountNo`:: Replace `{AWS_AccountNo}` with your AWS account number and `{Cluster_OIDC_Endpoint}` with the OIDC DNS identified earlier in this procedure.
+<1> Replace `{AWS_AccountNo}` with your AWS account number and `{Cluster_OIDC_Endpoint}` with the OIDC DNS identified earlier in this procedure.
 +
 .. Verify that the trust policy was assigned to the AWS IAM role.
 +
@@ -174,7 +165,7 @@ $ echo $OPERATOR_ROLE_ARN
 +
 For more information on creating AWS IAM roles, see link:https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html[Creating IAM roles].
 +
-.. Attach the Operator's permission policy to the role:
+.. Attach the operator's permission policy to the role:
 +
 [source, terminal]
 ----
@@ -349,7 +340,7 @@ spec:
   sourceNamespace: openshift-marketplace
   startingCSV: aws-load-balancer-operator.v1.0.0
 ----
-
++
 . Create an AWS ALBC:
 +
 [source,yaml]

modules/aws-load-balancer-operator-environment.adoc

@@ -5,14 +5,10 @@
 :_mod-docs-content-type: PROCEDURE
 [id="aws-uninstalling-an-aws-load-balancer-operator_{context}"]
 = Uninstalling an AWS Load Balancer Operator
-
-[role="_abstract"]
-To remove the AWS Load Balancer Operator and clean up associated resources, uninstall the Operator from the cluster. This ensures a complete cleanup of the environment and prevents unused resources from persisting.
+To uninstall an AWS Load Balancer Operator (ALBO) and perform an overall cleanup of the associated resources, perform the following procedure.
 
 .Procedure
-
-. Clean up the sample application by deleting the Load Balancers created and managed by the ALBO.
-
-. Clean up the AWS VPC tags by removing the VPC tags that were added to the subnets for discovering subnets and for creating Application Load Balancers (ALBs).
-
-. Clean up AWS Load Balancer Operator components by deleting both the AWS Load Balancer Operator and the Application Load Balancer Controller.
+. Clean up the sample application by deleting the Load Balancers created and managed by the ALBO. For more information about deleting Load Balancers, see link:https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-delete.html[Delete an Application Load Balancer].
+. Clean up the AWS VPC tags by removing the VPC tags that were added to the subnets for discovering subnets and for creating Application Load Balancers (ALBs). For more information, see link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-basics[Tag basics].
+. Clean up ALBO components by deleting both the ALBO and the Application Load Balancer Controller (ALBC).
+For more information, see link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.13/html/operators/administrator-tasks#olm-deleting-operators-from-a-cluster[Deleting Operators from a cluster].

modules/aws-load-balancer-operator-release-notes-1.0.0.adoc

@@ -6,7 +6,6 @@
 [id="using-ccoctl-create-iam-role-alb-controller_{context}"]
 = Creating an AWS IAM role for the controller by using the Cloud Credential Operator utility
 
-[role="_abstract"]
 You can use the Cloud Credential Operator utility (`ccoctl`) to create an {aws-short} IAM role for the {aws-short} Load Balancer Controller. An {aws-short} IAM role is used to interact with subnets and Virtual Private Clouds (VPCs).
 
 .Prerequisites
@@ -40,10 +39,7 @@ $ ccoctl aws create-iam-roles \
 2023/09/12 11:38:57 Saved credentials configuration to: /home/user/<credentials_requests_dir>/manifests/aws-load-balancer-operator-aws-load-balancer-controller-credentials.yaml
 2023/09/12 11:38:58 Updated Role policy for Role <name>-aws-load-balancer-operator-aws-load-balancer-controller created
 ----
-+
-where:
-+
-`<`name>`:: Specifies the Amazon Resource Name (ARN) for an {aws-short} IAM role that was created for the {aws-short} Load Balancer Controller, such as `arn:aws:iam::777777777777:role/<name>-aws-load-balancer-operator-aws-load-balancer-controller`.
+<1> Note the Amazon Resource Name (ARN) of an {aws-short} IAM role that was created for the {aws-short} Load Balancer Controller, such as `arn:aws:iam::777777777777:role/<name>-aws-load-balancer-operator-aws-load-balancer-controller`.
 +
 [NOTE]
 ====