run 'make docs'

codefresh-io · Jan 15, 2024 · 3560fc0 · 3560fc0
1 parent 5017335
commit 3560fc0
Show file tree

Hide file tree

Showing 5 changed files with 28 additions and 27 deletions.
diff --git a/docs/resources/abac_rules.md b/docs/resources/abac_rules.md
@@ -2,14 +2,14 @@
 page_title: "codefresh_abac_rules Resource - terraform-provider-codefresh"
 subcategory: ""
 description: |-
-  Gitops Abac Rules are used to setup access control and allow to define which teams have access to which resources based on tags and attributes.
+  Gitops ABAC Rules are used to setup access control and allow to define which teams have access to which resources based on tags and attributes.
 ---
 
 # codefresh_abac_rules (Resource)
 
-Gitops Abac Rules are used to setup access control and allow to define which teams have access to which resources based on tags and attributes.
+Gitops ABAC Rules are used to setup access control and allow to define which teams have access to which resources based on tags and attributes.
 
-See the [Access Control documentation](https://codefresh.io/docs/docs/administration/account-user-management/access-control/).
+See the [GitOps Access Control documentation](https://codefresh.io/docs/docs/administration/account-user-management/gitops-abac/).
 
 ## Example usage
 
@@ -48,17 +48,17 @@ resource "codefresh_abac_rules" "app_rule" {
 	* TERMINATE_SYNC
 	* VIEW_POD_LOGS
 	* APP_ROLLBACK
-- `entity_type` (String) The type of resources the abac rules applies to. Possible values:
+- `entity_type` (String) The type of resources the ABAC rules applies to. Possible values:
 	* gitopsApplications
-- `teams` (Set of String) The Ids of teams the abac rules apply to.
+- `teams` (Set of String) The IDs of the teams the ABAC rules apply to.
 
 ### Optional
 
 - `attribute` (Block List) Resource attribute that need to be validated (see [below for nested schema](#nestedblock--attribute))
 - `id` (String) The abac rule ID.
-- `tags` (Set of String) The effective tags to apply the permission. It supports 2 custom tags:
-	* untagged is a “tag” which refers to all resources that don't have any tag.
-	* (the star character) means all tags.
+- `tags` (Set of String) The effective tags of the resource to apply the permission to. There are two special tags:
+	* untagged: Apply to all resources without tags.
+	* * (asterisk): Apply to all resources with any tag.
 
 <a id="nestedblock--attribute"></a>
 ### Nested Schema for `attribute`

diff --git a/docs/resources/account.md b/docs/resources/account.md
@@ -49,11 +49,11 @@ resource "codefresh_account" "test" {
 - `build` (Block List) Build limits for this account. (see [below for nested schema](#nestedblock--build))
 - `features` (Map of Boolean) Features toggles for this account. Default:
 
-OfflineLogging: true
-ssoManagement: true
-teamsManagement: true
-abac: true
-customKubernetesCluster: true
+* OfflineLogging: true
+* ssoManagement: true
+* teamsManagement: true
+* abac: true
+* customKubernetesCluster: true
 - `limits` (Block List) Limits for this account. (see [below for nested schema](#nestedblock--limits))
 
 ### Read-Only
@@ -81,7 +81,7 @@ Required:
 
 Optional:
 
-- `data_retention_weeks` (Number) Specifies how long, in weeks, the builds be stored (default: `5`).
+- `data_retention_weeks` (Number) Specifies the number of weeks for which to store the builds (default: `5`).
 
 ## Import
 ```sh

diff --git a/docs/resources/account_admins.md b/docs/resources/account_admins.md
@@ -61,7 +61,7 @@ resource "codefresh_account_admins" "test" {
 
 ### Required
 
-- `account_id` (String) The account id where to set up a list of admins.
+- `account_id` (String) The account ID for which to set up the list of admins.
 - `users` (Set of String) A list of users to set up as account admins.
 
 ### Read-Only

diff --git a/docs/resources/context.md b/docs/resources/context.md
@@ -2,21 +2,22 @@
 page_title: "codefresh_context Resource - terraform-provider-codefresh"
 subcategory: ""
 description: |-
-  A Context is an authentication/configuration that is used by the Codefresh system and engine.
+  A Context is an authentication/configuration resource used by the Codefresh system and engine.
 ---
 
 # codefresh_context (Resource)
 
-A Context is an authentication/configuration that is used by the Codefresh system and engine.
+A Context is an authentication/configuration resource used by the Codefresh system and engine.
 
 ## Supported types
 
-There are multiple types of context available in Codefresh but they all have the following main components to define them:
+Codefresh supports multiple types of Contexts, all of which share the following components:
 
 * `Name`: A unique identifier for the context
 * `Type`: A string representing the type of context
-* `Data`: A data structure that provide the information related to the Context. This differs based on the type of context selected
-For more details of the Context spec see in the [CLI official documentation](https://codefresh-io.github.io/cli/contexts/spec/)
+* `Data`: A data structure that provides the information related to the Context. This differs based on the type of Context selected.
+
+For more details of the Context spec, please refer to the [official Codefresh CLI documentation](https://codefresh-io.github.io/cli/contexts/spec/)
 
 Currently the provider supports the following types of Context:
 
@@ -26,7 +27,7 @@ Currently the provider supports the following types of Context:
 * `secret-yaml` (Secret YAML Configuration Context)
 
 ### Shared Configuration
-A Shared Configuration is the entity in Codefresh that allow to create values in a central place that can then be consumed in pipelines to keep them DRY.
+A Shared Configuration is the entity in Codefresh where you can create values in a centralized location, and then consume in pipelines to keep them [DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself).
 More details in the official [Shared Configuration documentation](https://codefresh.io/docs/docs/configure-ci-cd-pipeline/shared-configuration/)
 
 ### Example Usage
@@ -225,4 +226,4 @@ Required:
 
 Required:
 
-- `data` (String) The YAML string representing the shared config.
+- `data` (String) The YAML string representing the shared config.
diff --git a/docs/resources/permission.md b/docs/resources/permission.md
@@ -2,12 +2,12 @@
 page_title: "codefresh_permission Resource - terraform-provider-codefresh"
 subcategory: ""
 description: |-
-  Permission are used to setup access control and allow to define which teams have access to which clusters and pipelines based on tags.
+  Permissions are used to set up access control and define which teams have access to which clusters and pipelines based on tags.
 ---
 
 # codefresh_permission (Resource)
 
-Permission are used to setup access control and allow to define which teams have access to which clusters and pipelines based on tags.
+Permissions are used to set up access control and define which teams have access to which clusters and pipelines based on tags.
 
 See the [Access Control documentation](https://codefresh.io/docs/docs/administration/account-user-management/access-control/).
 
@@ -59,9 +59,9 @@ resource "codefresh_permission" "developers" {
 - `_id` (String) The permission ID.
 - `related_resource` (String) Specifies the resource to use when evaluating the tags. Possible values:
 	* project
-- `tags` (Set of String) The effective tags to apply the permission. It supports 2 custom tags:
-	* untagged is a “tag” which refers to all clusters that don't have any tag.
-	* (the star character) means all tags.
+- `tags` (Set of String) The tags for which to apply the permission. Supports two custom tags:
+	* untagged:  Apply to all resources without tags
+  * (asterisk): Apply to all resources with any tag
 
 ### Read-Only