[CDS-55825]: docs review changes

.changelog/511.txt

@@ -0,0 +1,2 @@
+```release-note:new-resource
+platform_connector_terraform_cloud - Added a Terraform Cloud connector resource in the Harness Terraform provider.

docs/data-sources/platform_connector_terraform_cloud.md

@@ -30,7 +30,7 @@ data "harness_platform_connector_terraform_cloud" "example" {
 
 ### Read-Only
 
-- `credentials` (List of Object) Credentials to connect to Terraform Cloud platform. (see [below for nested schema](#nestedatt--credentials))
+- `credentials` (List of Object) Credentials to connect to the Terraform Cloud platform. (see [below for nested schema](#nestedatt--credentials))
 - `delegate_selectors` (Set of String) Tags to filter delegates for connection.
 - `description` (String) Description of the resource.
 - `id` (String) The ID of this resource.

docs/resources/platform_connector_terraform_cloud.md

@@ -3,17 +3,17 @@
 page_title: "harness_platform_connector_terraform_cloud Resource - terraform-provider-harness"
 subcategory: "Next Gen"
 description: |-
-  Resource for creating a TerraformCloud connector.
+  Resource for creating a Terraform Cloud connector.
 ---
 
 # harness_platform_connector_terraform_cloud (Resource)
 
-Resource for creating a TerraformCloud connector.
+Resource for creating a Terraform Cloud connector.
 
 ## Example Usage
 
 ```terraform
-# Create Terraform Cloud connector using API token as secret
+# Create a Terraform Cloud connector by using an API token as a secret.
 
 resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
   identifier         = "example_terraform_cloud_connector"
@@ -28,7 +28,7 @@ resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
   }
 }
 
-# Add connectivity mode by providing execute_on_delegate value. Default is to execute on Delegate
+# Specify the connectivity mode by setting execute_on_delegate to true or false. The default mode executes on the delegate.
 
 resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
   identifier          = "example_terraform_cloud_connector"
@@ -50,10 +50,10 @@ resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
 
 ### Required
 
-- `credentials` (Block List, Min: 1, Max: 1) Credentials to connect to Terraform Cloud platform. (see [below for nested schema](#nestedblock--credentials))
+- `credentials` (Block List, Min: 1, Max: 1) Credentials to connect to the Terraform Cloud platform. (see [below for nested schema](#nestedblock--credentials))
 - `identifier` (String) Unique identifier of the resource.
 - `name` (String) Name of the resource.
-- `url` (String) URL of Terraform Cloud platform.
+- `url` (String) URL of the Terraform Cloud platform.
 
 ### Optional
 
@@ -79,13 +79,13 @@ Required:
 
 Required:
 
-- `api_token_ref` (String) Reference to a secret containing the api token to use for authentication. To reference a secret at the organization scope, prefix 'org' to the expression: org.{identifier}. To reference a secret at the account scope, prefix 'account` to the expression: account.{identifier}.
+- `api_token_ref` (String) Reference to a secret containing the API token to use for authentication. To reference a secret at the organization scope, prefix 'org' to the expression: org.{identifier}. To reference a secret at the account scope, prefix 'account` to the expression: account.{identifier}.
 
 ## Import
 
 Import is supported using the following syntax:
 
 ```shell
-# Import using terrafrm cloud provider connector id
+# Import using the Terraform Cloud provider connector ID.
 terraform import harness_platform_connector_terraform_cloud.example <connector_id>
 ```

examples/resources/harness_platform_connector_terraform_cloud/import.sh

@@ -1,2 +1,2 @@
-# Import using terrafrm cloud provider connector id
+# Import using the Terraform Cloud provider connector ID.
 terraform import harness_platform_connector_terraform_cloud.example <connector_id>

examples/resources/harness_platform_connector_terraform_cloud/resource.tf

@@ -1,4 +1,4 @@
-# Create Terraform Cloud connector using API token as secret
+# Create a Terraform Cloud connector by using an API token as a secret.
 
 resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
   identifier         = "example_terraform_cloud_connector"
@@ -13,7 +13,7 @@ resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
   }
 }
 
-# Add connectivity mode by providing execute_on_delegate value. Default is to execute on Delegate
+# Specify the connectivity mode by setting execute_on_delegate to true or false. The default mode executes on the delegate.
 
 resource "harness_platform_connector_terraform_cloud" "terraform_cloud" {
   identifier          = "example_terraform_cloud_connector"

internal/service/platform/connector/terraform_cloud.go

@@ -13,20 +13,20 @@ import (
 
 func ResourceConnectorTerraformCloud() *schema.Resource {
 	resource := &schema.Resource{
-		Description:   "Resource for creating a TerraformCloud connector.",
+		Description:   "Resource for creating a Terraform Cloud connector.",
 		ReadContext:   resourceConnectorTerraformCloudRead,
 		CreateContext: resourceConnectorTerraformCloudCreateOrUpdate,
 		UpdateContext: resourceConnectorTerraformCloudCreateOrUpdate,
 		DeleteContext: resourceConnectorDelete,
 		Importer:      helpers.MultiLevelResourceImporter,
 		Schema: map[string]*schema.Schema{
 			"url": {
-				Description: "URL of Terraform Cloud platform.",
+				Description: "URL of the Terraform Cloud platform.",
 				Type:        schema.TypeString,
 				Required:    true,
 			},
 			"credentials": {
-				Description: "Credentials to connect to Terraform Cloud platform.",
+				Description: "Credentials to connect to the Terraform Cloud platform.",
 				Type:        schema.TypeList,
 				MaxItems:    1,
 				Required:    true,
@@ -40,7 +40,7 @@ func ResourceConnectorTerraformCloud() *schema.Resource {
 							Elem: &schema.Resource{
 								Schema: map[string]*schema.Schema{
 									"api_token_ref": {
-										Description: "Reference to a secret containing the api token to use for authentication." + secret_ref_text,
+										Description: "Reference to a secret containing the API token to use for authentication." + secret_ref_text,
 										Type:        schema.TypeString,
 										Required:    true,
 									},

internal/service/platform/connector/terraform_cloud_data_source.go

@@ -23,7 +23,7 @@ func DatasourceConnectorTerraformCloud() *schema.Resource {
 				Elem:        &schema.Schema{Type: schema.TypeString},
 			},
 			"credentials": {
-				Description: "Credentials to connect to Terraform Cloud platform.",
+				Description: "Credentials to connect to the Terraform Cloud platform.",
 				Type:        schema.TypeList,
 				Computed:    true,
 				Elem: &schema.Resource{
@@ -35,7 +35,7 @@ func DatasourceConnectorTerraformCloud() *schema.Resource {
 							Elem: &schema.Resource{
 								Schema: map[string]*schema.Schema{
 									"api_token_ref": {
-										Description: "Reference to a secret containing the api token to use for authentication." + secret_ref_text,
+										Description: "Reference to a secret containing the API token to use for authentication." + secret_ref_text,
 										Type:        schema.TypeString,
 										Computed:    true,
 									},