Merge pull request #1051 from timofurrer/docs/missing-examples

Adds missing examples in docs for the `gitlab_*_variable(s)` data sources

Author: timofurrer

docs/data-sources/group_variable.md

@@ -13,7 +13,21 @@ The `gitlab_group_variable` data source allows to retrieve details about a group
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/group_level_variables.html)
 
-
+## Example Usage
+
+```terraform
+data "gitlab_group_variable" "foo" {
+  group = "my/example/group"
+  key   = "foo"
+}
+
+# Using an environment scope
+data "gitlab_group_variable" "bar" {
+  group             = "my/example/group"
+  key               = "bar"
+  environment_scope = "staging/*"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/group_variables.md

@@ -13,7 +13,19 @@ The `gitlab_group_variables` data source allows to retrieve all group-level CI/C
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/group_level_variables.html)
 
-
+## Example Usage
+
+```terraform
+data "gitlab_group_variables" "vars" {
+  group = "my/example/group"
+}
+
+# Using an environment scope
+data "gitlab_group_variables" "staging_vars" {
+  group             = "my/example/group"
+  environment_scope = "staging/*"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/instance_variable.md

@@ -13,7 +13,13 @@ The `gitlab_instance_variable` data source allows to retrieve details about an i
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/instance_level_ci_variables.html)
 
+## Example Usage
 
+```terraform
+data "gitlab_instance_variable" "foo" {
+  key = "foo"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/instance_variables.md

@@ -13,7 +13,11 @@ The `gitlab_instance_variables` data source allows to retrieve all instance-leve
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/instance_level_ci_variables.html)
 
+## Example Usage
 
+```terraform
+data "gitlab_instance_variables" "vars" {}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/project_variable.md

@@ -13,7 +13,21 @@ The `gitlab_project_variable` data source allows to retrieve details about a pro
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/project_level_variables.html)
 
-
+## Example Usage
+
+```terraform
+data "gitlab_project_variable" "foo" {
+  project = "my/example/project"
+  key     = "foo"
+}
+
+# Using an environment scope
+data "gitlab_project_variable" "bar" {
+  project           = "my/example/project"
+  key               = "bar"
+  environment_scope = "staging/*"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/project_variables.md

@@ -13,7 +13,19 @@ The `gitlab_project_variables` data source allows to retrieve all project-level
 
 **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/project_level_variables.html)
 
-
+## Example Usage
+
+```terraform
+data "gitlab_project_variables" "vars" {
+  project = "my/example/project"
+}
+
+# Using an environment scope
+data "gitlab_project_variables" "staging_vars" {
+  project           = "my/example/project"
+  environment_scope = "staging/*"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

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

@@ -0,0 +1,11 @@
+data "gitlab_group_variable" "foo" {
+  group = "my/example/group"
+  key   = "foo"
+}
+
+# Using an environment scope
+data "gitlab_group_variable" "bar" {
+  group             = "my/example/group"
+  key               = "bar"
+  environment_scope = "staging/*"
+}

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

@@ -0,0 +1,9 @@
+data "gitlab_group_variables" "vars" {
+  group = "my/example/group"
+}
+
+# Using an environment scope
+data "gitlab_group_variables" "staging_vars" {
+  group             = "my/example/group"
+  environment_scope = "staging/*"
+}

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

@@ -0,0 +1,3 @@
+data "gitlab_instance_variable" "foo" {
+  key = "foo"
+}

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

@@ -0,0 +1 @@
+data "gitlab_instance_variables" "vars" {}