General TF Updates

Author: EricPonvelle

docs/guides/cluster-admin.md

@@ -0,0 +1,31 @@
+---
+page_title: "Creating Cluster Admin ROSA Cluster"
+subcategory: ""
+description: |-
+  Instructions on how to create a Rosa Openshift cluster admin when you create your cluster with the terraform provider.
+---
+
+# Creating a cluster admin user for your ROSA cluster
+
+You can create a Cluster Admin user for your cluster using Terraform.
+
+## Prerequisites
+
+1. You created your [account roles using Terraform](../examples/create_rosa_cluster/create_rosa_sts_cluster/classic_sts/account_roles/README.md).
+
+## Creating a cluster administrator by using Terraform
+
+You must implement the following parameters to create your Cluster Admin role on cluster creation using the htpsswd identity provider.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `admin_credentials` | Attributes | This attribute list defines the user name and password for a cluster admin user. |
+| `password` | Case-sensitive String | Enter the cluster admin's password that will be created with the cluster. NOTE: This field is case sensitive. |
+| `username` | String | Enter your cluster admin's username that will be created with the cluster. |
+
+1. Add these parameters to your cluster creation `variables.tf` and `main.tf` files.
+1. Run `terraform apply` to upgrade your cluster.
+
+## OpenShift documentation
+
+ - [Configuring an htpasswd identity provider](https://docs.openshift.com/rosa/rosa_install_access_delete_clusters/rosa-sts-config-identity-providers.html#config-htpasswd-idp_rosa-sts-config-identity-providers)

docs/guides/machine-pool.md

@@ -62,35 +62,16 @@ This provider is currently under development, and new releases are regularly mad
 
 There are two distinct types of releases:
 
-* Stable releases: Any release identified by a version number without any preffix, such as 1.2.0. These versions are officially supported by RedHat.
+* Stable releases: Any release identified by a version number without any prefix, such as 1.2.0. These versions are officially supported by RedHat.
 * Pre-release versions: These are beta versions of the provider, identified by a version number with a suffix introduced by a dash, such as 1.2.0-beta. While users can utilize these pre-release versions, it's important to note that doing so comes with the responsibility of the user, as they may not be as stable or fully supported as official releases.
 
 ## Prerequisites
 
 To use the Red Hat Cloud Services provider inside your Terraform configuration you must meet the following:
 
-* Completed [the ROSA getting started](https://console.redhat.com/openshift/create/rosa/getstarted) requirements
-
-  You must complete some AWS account and local configurations to create and managed ROSA clusters.
-
-* An offline [OCM token](https://console.redhat.com/openshift/token/rosa)
-
-  This token is generated through the Red Hat Hybrid Cloud Console. The purpose of this token is to verify that you have access and permission to create and upgrade clusters. This token is unique to your account and should not be shared.
-
-* [GoLang version 1.20 or newer](https://go.dev/doc/install)
-
-  To build components with Terraform, you must have the latest version of Go installed and usable on your system.
-
-* [Terraform version 1.4.6 or newer](https://developer.hashicorp.com/terraform/downloads)
-
-  You need to have Terraform configured for your local system. The Terraform website contains installation options for MacOS, Windows, and Linux.
-
-* [ROSA account roles](https://access.redhat.com/documentation/en-us/red_hat_openshift_service_on_aws/4/html/introduction_to_rosa/rosa-sts-about-iam-resources)
-
-  You need to have created the AWS account-wide roles. The specific account-wide IAM roles and policies provide the STS permissions required for ROSA support, installation, control plane, and compute functionality. This includes account-wide Operator policies.
-
-  To create the account roles using Terraform, see the [Account Roles Terraform example](https://github.com/terraform-redhat/terraform-provider-rhcs/tree/v1.4.0/examples/create_account_roles/).
-
+* You completed [the ROSA getting started](https://console.redhat.com/openshift/create/rosa/getstarted) requirements.
+* You generated an offline [OCM token](https://console.redhat.com/openshift/token/rosa). This token is generated through the Red Hat Hybrid Cloud Console. Do not share this token.
+* You have [Terraform version 1.4.6 or newer](https://developer.hashicorp.com/terraform/downloads) installed.
 * AWS Permissions
 
   The following excerpt lists the minimum AWS permissions required to run Terraform.

docs/index.md

@@ -53,7 +53,7 @@ resource "rhcs_cluster_rosa_classic" "rosa_sts_cluster" {
 
 ### Optional
 
-- `admin_credentials` (Attributes) Admin user credentials (see [below for nested schema](#nestedatt--admin_credentials))
+- `admin_credentials` (Attributes) This attribute list defines the user name and password for a cluster admin user. (see [below for nested schema](#nestedatt--admin_credentials))
 - `autoscaling_enabled` (Boolean) Enables autoscaling.
 - `availability_zones` (List of String) Availability zones.
 - `aws_private_link` (Boolean) Provides private connectivity from your cluster's VPC to Red Hat SRE, without exposing traffic to the public internet.
@@ -105,8 +105,8 @@ resource "rhcs_cluster_rosa_classic" "rosa_sts_cluster" {
 
 Required:
 
-- `password` (String, Sensitive) Admin password that will be created with the cluster.
-- `username` (String) Admin username that will be created with the cluster.
+- `password` (String, Sensitive) Enter the cluster admin's password that will be created with the cluster. NOTE: This field is case sensitive.
+- `username` (String) Enter your cluster admin's username that will be created with the cluster.
 
 
 <a id="nestedatt--private_hosted_zone"></a>