diff --git a/docs/data-sources/environments.md b/docs/data-sources/environments.md
index bd9701e50..fe2db8529 100644
--- a/docs/data-sources/environments.md
+++ b/docs/data-sources/environments.md
@@ -46,7 +46,6 @@ Required:
 Optional:
 
 - `allow_dynamic_infrastructure` (Boolean)
-- `description` (String) The description of this environment.
 - `id` (String) The unique ID for this resource.
 - `jira_extension_settings` (Attributes List) Provides extension settings for the Jira integration for this environment. (see [below for nested schema](#nestedatt--environments--jira_extension_settings))
 - `jira_service_management_extension_settings` (Attributes List) Provides extension settings for the Jira Service Management (JSM) integration for this environment. (see [below for nested schema](#nestedatt--environments--jira_service_management_extension_settings))
@@ -56,6 +55,10 @@ Optional:
 - `space_id` (String) The space ID associated with this environment.
 - `use_guided_failure` (Boolean)
 
+Read-Only:
+
+- `description` (String) The description of this environment.
+
 <a id="nestedatt--environments--jira_extension_settings"></a>
 ### Nested Schema for `environments.jira_extension_settings`
 
diff --git a/docs/data-sources/git_credentials.md b/docs/data-sources/git_credentials.md
index f5731b945..16eba8ac5 100644
--- a/docs/data-sources/git_credentials.md
+++ b/docs/data-sources/git_credentials.md
@@ -32,13 +32,13 @@ A list of Git Credentials that match the filter(s).
 
 Optional:
 
-- `description` (String) The description of this Git Credential.
 - `id` (String) The unique ID for this resource.
 - `name` (String) A filter search by exact name
 - `space_id` (String) The space ID associated with this Git Credential.
 
 Read-Only:
 
+- `description` (String) The description of this Git Credential.
 - `type` (String) The Git credential authentication type.
 - `username` (String) The username for the Git credential.
 
diff --git a/docs/data-sources/lifecycles.md b/docs/data-sources/lifecycles.md
index 681ec7f59..b637d14d8 100644
--- a/docs/data-sources/lifecycles.md
+++ b/docs/data-sources/lifecycles.md
@@ -46,12 +46,12 @@ Required:
 
 Optional:
 
-- `description` (String) The description of this lifecycle.
 - `id` (String) The unique ID for this resource.
 - `space_id` (String) The space ID associated with this lifecycle.
 
 Read-Only:
 
+- `description` (String) The description of this lifecycle.
 - `phase` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--phase))
 - `release_retention_policy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--release_retention_policy))
 - `tentacle_retention_policy` (Attributes List) (see [below for nested schema](#nestedatt--lifecycles--tentacle_retention_policy))
diff --git a/docs/resources/tenant_common_variable.md b/docs/resources/tenant_common_variable.md
index 4c1c54054..c306e3c59 100644
--- a/docs/resources/tenant_common_variable.md
+++ b/docs/resources/tenant_common_variable.md
@@ -3,12 +3,12 @@
 page_title: "octopusdeploy_tenant_common_variable Resource - terraform-provider-octopusdeploy"
 subcategory: ""
 description: |-
-  This resource manages tenant common variables in Octopus Deploy.
+  Manages a tenant common variable in Octopus Deploy.
 ---
 
 # octopusdeploy_tenant_common_variable (Resource)
 
-This resource manages tenant common variables in Octopus Deploy.
+Manages a tenant common variable in Octopus Deploy.
 
 
 
@@ -17,17 +17,14 @@ This resource manages tenant common variables in Octopus Deploy.
 
 ### Required
 
-- `library_variable_set_id` (String)
-- `template_id` (String)
-- `tenant_id` (String)
+- `library_variable_set_id` (String) The ID of the library variable set.
+- `template_id` (String) The ID of the variable template.
+- `tenant_id` (String) The ID of the tenant.
 
 ### Optional
 
-- `space_id` (String)
-- `value` (String, Sensitive)
-
-### Read-Only
-
-- `id` (String) The ID of this resource.
+- `id` (String) The unique ID for this resource.
+- `space_id` (String) The space ID associated with this Tenant Common Variable.
+- `value` (String, Sensitive) The value of the variable.
 
 
diff --git a/docs/resources/tenant_project.md b/docs/resources/tenant_project.md
index f537e8fcc..2558f847b 100644
--- a/docs/resources/tenant_project.md
+++ b/docs/resources/tenant_project.md
@@ -3,12 +3,12 @@
 page_title: "octopusdeploy_tenant_project Resource - terraform-provider-octopusdeploy"
 subcategory: ""
 description: |-
-  This resource represents the connection between tenants and projects.
+  
 ---
 
 # octopusdeploy_tenant_project (Resource)
 
-This resource represents the connection between tenants and projects.
+
 
 
 
@@ -22,11 +22,8 @@ This resource represents the connection between tenants and projects.
 
 ### Optional
 
-- `environment_ids` (List of String) The environment ID associated with this tenant.
-- `space_id` (String) The space ID associated with this resource.
-
-### Read-Only
-
-- `id` (String) The ID of this resource.
+- `environment_ids` (List of String) The environment IDs associated with this tenant.
+- `id` (String) The unique ID for this resource.
+- `space_id` (String) The space ID associated with this project tenant.
 
 
diff --git a/docs/resources/tenant_project_variable.md b/docs/resources/tenant_project_variable.md
index c27b1afae..f69e6f30b 100644
--- a/docs/resources/tenant_project_variable.md
+++ b/docs/resources/tenant_project_variable.md
@@ -3,12 +3,12 @@
 page_title: "octopusdeploy_tenant_project_variable Resource - terraform-provider-octopusdeploy"
 subcategory: ""
 description: |-
-  This resource manages tenant project variables in Octopus Deploy.
+  Manages a tenant project variable in Octopus Deploy.
 ---
 
 # octopusdeploy_tenant_project_variable (Resource)
 
-This resource manages tenant project variables in Octopus Deploy.
+Manages a tenant project variable in Octopus Deploy.
 
 
 
@@ -17,18 +17,15 @@ This resource manages tenant project variables in Octopus Deploy.
 
 ### Required
 
-- `environment_id` (String)
-- `project_id` (String)
-- `template_id` (String)
-- `tenant_id` (String)
+- `environment_id` (String) The ID of the environment.
+- `project_id` (String) The ID of the project.
+- `template_id` (String) The ID of the variable template.
+- `tenant_id` (String) The ID of the tenant.
 
 ### Optional
 
-- `space_id` (String)
-- `value` (String, Sensitive)
-
-### Read-Only
-
-- `id` (String) The ID of this resource.
+- `id` (String) The unique ID for this resource.
+- `space_id` (String) The space ID associated with this Tenant Project Variable.
+- `value` (String, Sensitive) The value of the variable.
 
 
diff --git a/octopusdeploy_framework/schemas/tenant_project_variable.go b/octopusdeploy_framework/schemas/tenant_project_variable.go
index 99553e7c6..464a84baf 100644
--- a/octopusdeploy_framework/schemas/tenant_project_variable.go
+++ b/octopusdeploy_framework/schemas/tenant_project_variable.go
@@ -21,7 +21,7 @@ func GetTenantProjectVariableResourceSchema() schema.Schema {
 			"environment_id": util.GetRequiredStringResourceSchema("The ID of the environment."),
 			"template_id":    util.GetRequiredStringResourceSchema("The ID of the variable template."),
 			"value": schema.StringAttribute{
-				Required:    true,
+				Optional:    true,
 				Description: "The value of the variable.",
 				Sensitive:   true,
 			},