ROSA Docs: Fixed broken links; restructured topic

adellape · Mar 22, 2022 · 82eae90 · 82eae90
1 parent 0862b4b
commit 82eae90
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 18 deletions.
diff --git a/modules/rosa-sts-about-iam-resources.adoc b/modules/rosa-sts-about-iam-resources.adoc
diff --git a/rosa_getting_started/rosa-sts-about-iam-resources.adoc b/rosa_getting_started/rosa-sts-about-iam-resources.adoc
@@ -6,13 +6,19 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
-include::modules/rosa-sts-about-iam-resources.adoc[leveloffset=+1]
+To deploy a {product-title} (ROSA) cluster that uses the AWS Security Token Service (STS), you must create the following AWS Identity Access Management (IAM) resources:
+
+* Specific account-wide IAM roles and policies that provide the STS permissions required for ROSA support, installation, control plane, and compute functionality. This includes account-wide Operator policies.
+* Cluster-specific Operator IAM roles that permit the ROSA cluster Operators to carry out core OpenShift functionality.
+* An OpenID Connect (OIDC) provider that the cluster Operators use to authenticate.
+
+This document provides reference information about the IAM resources that you must deploy when you create a ROSA cluster that uses STS. It also includes the `aws` CLI commands that are generated when you use `manual` mode with the `rosa create` command.
 
 [role="_additional-resources"]
 .Additional resources
 
-* For steps to quickly create a ROSA cluster with STS, including the AWS IAM resources, see xref:../rosa-sts-creating-a-cluster-quickly.adoc#rosa-sts-creating-a-cluster-quickly[Creating a ROSA cluster with STS quickly].
-* For steps to create a ROSA cluster with STS using customizations, including the AWS IAM resources, see xref:../rosa-sts-creating-a-cluster-with-customizations.adoc#rosa-sts-creating-a-cluster-with-customizations[Creating a ROSA cluster with STS using customizations].
+* For steps to quickly create a ROSA cluster with STS, including the AWS IAM resources, see xref:../rosa_getting_started/rosa-sts-creating-a-cluster-quickly.adoc#rosa-sts-creating-a-cluster-quickly[Creating a ROSA cluster with STS quickly].
+* For steps to create a ROSA cluster with STS using customizations, including the AWS IAM resources, see xref:../rosa_getting_started/rosa-sts-creating-a-cluster-with-customizations.adoc#rosa-sts-creating-a-cluster-with-customizations[Creating a ROSA cluster with STS using customizations].
 
 include::modules/rosa-sts-account-wide-roles-and-policies.adoc[leveloffset=+1]