(Auto-generated) Migrate documentation

- Move attribute documentation to resource schemas
- Move examples to /examples

Author: armsnyder

examples/data-sources/gitlab_group/data-source.tf

@@ -0,0 +1,9 @@
+# By group's ID
+data "gitlab_group" "foo" {
+  group_id = 123
+}
+
+# By group's full path
+data "gitlab_group" "foo" {
+  full_path = "foo/bar"
+}

examples/data-sources/gitlab_group_membership/data-source.tf

@@ -0,0 +1,9 @@
+# By group's ID
+data "gitlab_group_membership" "example" {
+  group_id = 123
+}
+
+# By group's full path
+data "gitlab_group_membership" "example" {
+  full_path = "foo/bar"
+}

examples/data-sources/gitlab_project/data-source.tf

@@ -0,0 +1,7 @@
+data "gitlab_project" "example" {
+  id = 30
+}
+
+data "gitlab_project" "example" {
+  id = "foo/bar/baz"
+}

examples/data-sources/gitlab_project_protected_branch/data-source.tf

@@ -0,0 +1,9 @@
+data "gitlab_project_protected_branch" "example" {
+  project_id = 30
+  name       = "main"
+}
+
+data "gitlab_project_protected_branch" "example" {
+  project_id = "foo/bar/baz"
+  name       = "main"
+}

examples/data-sources/gitlab_project_protected_branches/data-source.tf

@@ -0,0 +1,7 @@
+data "gitlab_project_protected_branches" "example" {
+  project_id = 30
+}
+
+data "gitlab_project_protected_branches" "example" {
+  project_id = "foo/bar/baz"
+}

examples/data-sources/gitlab_projects/data-source.tf

@@ -0,0 +1,17 @@
+# List projects within a group tree
+data "gitlab_group" "mygroup" {
+  full_path = "mygroup"
+}
+
+data "gitlab_projects" "group_projects" {
+  group_id          = data.gitlab_group.mygroup.id
+  order_by          = "name"
+  include_subgroups = true
+  with_shared       = false
+}
+
+# List projects using the search syntax
+data "gitlab_projects" "projects" {
+  search              = "postgresql"
+  visibility          = "private"
+}

examples/data-sources/gitlab_user/data-source.tf

@@ -0,0 +1,10 @@
+data "gitlab_user" "example" {
+  username = "myuser"
+}
+
+# Example using `for_each`
+data "gitlab_user" "example-two" {
+  for_each = toset(["user1", "user2", "user3"])
+
+  username = each.value
+}

examples/data-sources/gitlab_users/data-source.tf

@@ -0,0 +1,9 @@
+data "gitlab_users" "example" {
+  sort = "desc"
+  order_by = "name"
+  created_before = "2019-01-01"
+}
+
+data "gitlab_users" "example-two" {
+  search = "username"
+}

examples/resources/gitlab_branch_protection/import.sh

@@ -0,0 +1,2 @@
+# Gitlab protected branches can be imported with a key composed of `<project_id>:<branch>`, e.g.
+terraform import gitlab_branch_protection.BranchProtect "12345:main"

examples/resources/gitlab_branch_protection/resource.tf

@@ -0,0 +1,34 @@
+resource "gitlab_branch_protection" "BranchProtect" {
+  project                      = "12345"
+  branch                       = "BranchProtected"
+  push_access_level            = "developer"
+  merge_access_level           = "developer"
+  code_owner_approval_required = true
+  allowed_to_push {
+    user_id = 5
+  }
+  allowed_to_push {
+    user_id = 521
+  }
+  allowed_to_merge {
+    user_id = 15
+  }
+  allowed_to_merge {
+    user_id = 37
+  }
+}
+
+# Example using dynamic block
+resource "gitlab_branch_protection" "main" {
+  project                      = "12345"
+  branch                       = "main"
+  push_access_level            = "maintainer"
+  merge_access_level           = "maintainer"
+
+  dynamic "allowed_to_push" {
+    for_each = [50, 55, 60]
+    content {
+      user_id = allowed_to_push.value
+    }
+  }
+}