(Generated) Generate all documentation from schemas

Author: armsnyder

docs/data-sources/group.md

@@ -1,63 +1,53 @@
-# gitlab\_group
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_group Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  Provide details about a specific group in the gitlab provider.
+  Note: exactly one of groupid or fullpath must be provided.
+---
+
+# gitlab_group (Data Source)
 
 Provide details about a specific group in the gitlab provider.
 
-## Example Usage
+> **Note**: exactly one of group_id or full_path must be provided.
 
-### By group's ID
+## Example Usage
 
-```hcl
+```terraform
+# By group's ID
 data "gitlab_group" "foo" {
   group_id = 123
 }
-```
 
-### By group's full path
-
-```hcl
+# By group's full path
 data "gitlab_group" "foo" {
   full_path = "foo/bar"
 }
 ```
 
-## Argument Reference
-
-The following arguments are supported:
-
-* `group_id` - (Optional) The ID of the group.
-
-* `full_path` - (Optional) The full path of the group.
-
-> **Note**: exactly one of group_id or full_path must be provided.
-
-## Attributes Reference
-
-The resource exports the following attributes:
-
-* `id` - The unique ID assigned to the group.
-
-* `name` - The name of this group.
-
-* `path` - The path of the group.
-
-* `description` - The description of the group.
-
-* `lfs_enabled` - Boolean, is LFS enabled for projects in this group.
-
-* `request_access_enabled` - Boolean, is request for access enabled to the group.
-
-* `visibility_level` - Visibility level of the group. Possible values are `private`, `internal`, `public`.
+<!-- schema generated by tfplugindocs -->
+## Schema
 
-* `parent_id` - Integer, ID of the parent group.
-  
-* `full_path` - The full path of the group.
+### Optional
 
-* `full_name` - The full name of the group.
+- **full_path** (String) The full path of the group.
+- **group_id** (Number) The ID of the group.
+- **id** (String) The ID of this resource.
 
-* `web_url` - Web URL of the group.
+### Read-Only
 
-* `runners_token` - The group level registration token to use during runner setup.
+- **default_branch_protection** (Number) Whether developers and maintainers can push to the applicable default branch.
+- **description** (String) The description of the group.
+- **full_name** (String) The full name of the group.
+- **lfs_enabled** (Boolean) Boolean, is LFS enabled for projects in this group.
+- **name** (String) The name of this group.
+- **parent_id** (Number) Integer, ID of the parent group.
+- **path** (String) The path of the group.
+- **request_access_enabled** (Boolean) Boolean, is request for access enabled to the group.
+- **runners_token** (String, Sensitive) The group level registration token to use during runner setup.
+- **visibility_level** (String) Visibility level of the group. Possible values are `private`, `internal`, `public`.
+- **web_url** (String) Web URL of the group.
 
-* `default_branch_protection` - Whether developers and maintainers can push to the applicable default branch.
 
-[doc]: https://docs.gitlab.com/ee/api/groups.html#details-of-a-group

docs/data-sources/group_membership.md

@@ -1,47 +1,58 @@
-# gitlab\_group\_membership
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_group_membership Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  Provide details about a list of group members in the gitlab provider. The results include id, username, name and more about the requested members.
+  Note: exactly one of groupid or fullpath must be provided.
+---
+
+# gitlab_group_membership (Data Source)
 
 Provide details about a list of group members in the gitlab provider. The results include id, username, name and more about the requested members.
 
-## Example Usage
+> **Note**: exactly one of group_id or full_path must be provided.
 
-### By group's ID
+## Example Usage
 
-```hcl
+```terraform
+# By group's ID
 data "gitlab_group_membership" "example" {
   group_id = 123
 }
-```
-
-### By group's full path
 
-```hcl
+# By group's full path
 data "gitlab_group_membership" "example" {
   full_path = "foo/bar"
 }
 ```
 
-## Argument Reference
+<!-- schema generated by tfplugindocs -->
+## Schema
 
-The following arguments are supported:
+### Optional
 
-* `group_id` - (Optional) The ID of the group.
+- **access_level** (String) Only return members with the desired access level. Acceptable values are: `guest`, `reporter`, `developer`, `maintainer`, `owner`.
+- **full_path** (String) The full path of the group.
+- **group_id** (Number) The ID of the group.
+- **id** (String) The ID of this resource.
 
-* `full_path` - (Optional) The full path of the group.
+### Read-Only
 
-* `access_level` - (Optional) Only return members with the desired access level. Acceptable values are: `guest`, `reporter`, `developer`, `maintainer`, `owner`.
+- **members** (List of Object) The list of group members. (see [below for nested schema](#nestedatt--members))
 
-> **Note**: exactly one of group_id or full_path must be provided.
+<a id="nestedatt--members"></a>
+### Nested Schema for `members`
+
+Read-Only:
 
-## Attributes Reference
+- **access_level** (String)
+- **avatar_url** (String)
+- **expires_at** (String)
+- **id** (Number)
+- **name** (String)
+- **state** (String)
+- **username** (String)
+- **web_url** (String)
 
-The following attributes are exported:
 
-* `members` - The list of group members.
-  * `id` - The unique id assigned to the user by the gitlab server.
-  * `username` - The username of the user.
-  * `name` - The name of the user.
-  * `state` - Whether the user is active or blocked.
-  * `avatar_url` - The avatar URL of the user.
-  * `web_url` - User's website URL.
-  * `access_level` - One of five levels of access to the group.
-  * `expires_at` - Expiration date for the group membership.

docs/data-sources/project.md

@@ -1,104 +1,73 @@
-# gitlab\_project
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_project Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  Provide details about a specific project in the gitlab provider. The results include the name of the project, path, description, default branch, etc.
+---
+
+# gitlab_project (Data Source)
 
 Provide details about a specific project in the gitlab provider. The results include the name of the project, path, description, default branch, etc.
 
 ## Example Usage
 
-```hcl
+```terraform
 data "gitlab_project" "example" {
   id = 30
 }
-```
 
-```hcl
 data "gitlab_project" "example" {
   id = "foo/bar/baz"
 }
 ```
 
-## Argument Reference
-
-The following arguments are supported:
-
-* `id` - (Required) The integer or path with namespace that uniquely identifies the project within the gitlab install.
-
-## Attributes Reference
-
-The following attributes are exported:
-
-* `path` - The path of the repository.
-
-* `path_with_namespace` - The path of the repository with namespace.
-
-* `namespace_id` - The namespace (group or user) of the project. Defaults to your user.
-  See [`gitlab_group`](../resources/group) for an example.
-
-* `description` - A description of the project.
-
-* `default_branch` - The default branch for the project.
-
-* `request_access_enabled` - Allow users to request member access.
-
-* `issues_enabled` - Enable issue tracking for the project.
-
-* `merge_requests_enabled` - Enable merge requests for the project.
-
-* `pipelines_enabled` - Enable pipelines for the project.
-
-* `wiki_enabled` - Enable wiki for the project.
-
-* `snippets_enabled` - Enable snippets for the project.
-
-* `lfs_enabled` - Enable LFS for the project.
-
-* `visibility_level` -  Repositories are created as private by default.
-
-* `id` - Integer that uniquely identifies the project within the gitlab install.
-
-* `ssh_url_to_repo` - URL that can be provided to `git clone` to clone the
-  repository via SSH.
-
-* `http_url_to_repo` - URL that can be provided to `git clone` to clone the
-  repository via HTTP.
-
-* `web_url` - URL that can be used to find the project in a browser.
-
-* `runners_token` - Registration token to use during runner setup.
-
-* `archived` - Whether the project is in read-only mode (archived).
-
-* `remove_source_branch_after_merge` - Enable `Delete source branch` option by default for all new merge requests
-
-* `packages_enabled` - Enable packages repository for the project.
-
-* `push_rules` Push rules for the project (documented below).
-
-## Nested Blocks
-
-### push_rules
-
-For information on push rules, consult the [GitLab documentation](https://docs.gitlab.com/ce/push_rules/push_rules.html#push-rules).
-
-#### Attributes
-
-* `author_email_regex` - All commit author emails must match this regex, e.g. `@my-company.com$`.
-
-* `branch_name_regex` - All branch names must match this regex, e.g. `(feature|hotfix)\/*`.
-
-* `commit_message_regex` - All commit messages must match this regex, e.g. `Fixed \d+\..*`.
-
-* `commit_message_negative_regex` - No commit message is allowed to match this regex, for example `ssh\:\/\/`.
-
-* `file_name_regex` - All commited filenames must not match this regex, e.g. `(jar|exe)$`.
-
-* `commit_committer_check` - Users can only push commits to this repository that were committed with one of their own verified emails.
-
-* `deny_delete_tag` - Deny deleting a tag.
-
-* `member_check` - Restrict commits by author (email) to existing GitLab users.
-
-* `prevent_secrets` - GitLab will reject any files that are likely to contain secrets.
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- **id** (String) The integer or path with namespace that uniquely identifies the project within the gitlab install.
+- **path_with_namespace** (String) The path of the repository with namespace.
+
+### Read-Only
+
+- **archived** (Boolean) Whether the project is in read-only mode (archived).
+- **default_branch** (String) The default branch for the project.
+- **description** (String) A description of the project.
+- **http_url_to_repo** (String) URL that can be provided to `git clone` to clone the
+- **issues_enabled** (Boolean) Enable issue tracking for the project.
+- **lfs_enabled** (Boolean) Enable LFS for the project.
+- **merge_requests_enabled** (Boolean) Enable merge requests for the project.
+- **name** (String) The name of the project.
+- **namespace_id** (Number) The namespace (group or user) of the project. Defaults to your user.
+- **path** (String) The path of the repository.
+- **pipelines_enabled** (Boolean) Enable pipelines for the project.
+- **push_rules** (List of Object) Push rules for the project. (see [below for nested schema](#nestedatt--push_rules))
+- **remove_source_branch_after_merge** (Boolean) Enable `Delete source branch` option by default for all new merge requests
+- **request_access_enabled** (Boolean) Allow users to request member access.
+- **runners_token** (String) Registration token to use during runner setup.
+- **snippets_enabled** (Boolean) Enable snippets for the project.
+- **ssh_url_to_repo** (String) URL that can be provided to `git clone` to clone the
+- **visibility_level** (String) Repositories are created as private by default.
+- **web_url** (String) URL that can be used to find the project in a browser.
+- **wiki_enabled** (Boolean) Enable wiki for the project.
+
+<a id="nestedatt--push_rules"></a>
+### Nested Schema for `push_rules`
+
+Read-Only:
+
+- **author_email_regex** (String)
+- **branch_name_regex** (String)
+- **commit_committer_check** (Boolean)
+- **commit_message_negative_regex** (String)
+- **commit_message_regex** (String)
+- **deny_delete_tag** (Boolean)
+- **file_name_regex** (String)
+- **max_file_size** (Number)
+- **member_check** (Boolean)
+- **prevent_secrets** (Boolean)
+- **reject_unsigned_commits** (Boolean)
 
-* `reject_unsigned_commits` - Reject commit when it’s not signed through GPG.
 
-* `max_file_size` - Maximum file size (MB).