make gen

Author: stirby

docs/data-sources/parameter.md

@@ -10,7 +10,127 @@ description: |-
 
 Use this data source to configure editable options for workspaces.
 
-
+## Example Usage
+
+```terraform
+provider "coder" {}
+
+data "coder_parameter" "example" {
+  name        = "Region"
+  description = "Specify a region to place your workspace."
+  mutable     = false
+  type        = "string"
+  default     = "asia-central1-a"
+  option {
+    value = "us-central1-a"
+    name  = "US Central"
+    icon  = "/icon/usa.svg"
+  }
+  option {
+    value = "asia-central1-a"
+    name  = "Asia"
+    icon  = "/icon/asia.svg"
+  }
+}
+
+data "coder_parameter" "ami" {
+  name        = "Machine Image"
+  description = <<-EOT
+    # Provide the machine image
+    See the [registry](https://container.registry.blah/namespace) for options.
+    EOT
+  option {
+    value = "ami-xxxxxxxx"
+    name  = "Ubuntu"
+    icon  = "/icon/ubuntu.svg"
+  }
+}
+
+data "coder_parameter" "is_public_instance" {
+  name    = "Is public instance?"
+  type    = "bool"
+  icon    = "/icon/docker.svg"
+  default = false
+}
+
+data "coder_parameter" "cores" {
+  name    = "CPU Cores"
+  type    = "number"
+  icon    = "/icon/cpu.svg"
+  default = 3
+  order   = 10
+}
+
+data "coder_parameter" "disk_size" {
+  name    = "Disk Size"
+  type    = "number"
+  default = "5"
+  order   = 8
+  validation {
+    # This can apply to number.
+    min       = 0
+    max       = 10
+    monotonic = "increasing"
+  }
+}
+
+data "coder_parameter" "cat_lives" {
+  name    = "Cat Lives"
+  type    = "number"
+  default = "9"
+  validation {
+    # This can apply to number.
+    min       = 0
+    max       = 10
+    monotonic = "decreasing"
+  }
+}
+
+data "coder_parameter" "fairy_tale" {
+  name      = "Fairy Tale"
+  type      = "string"
+  mutable   = true
+  default   = "Hansel and Gretel"
+  ephemeral = true
+}
+
+data "coder_parameter" "users" {
+  name         = "system_users"
+  display_name = "System users"
+  type         = "list(string)"
+  default      = jsonencode(["root", "user1", "user2"])
+}
+
+data "coder_parameter" "home_volume_size" {
+  name        = "Home Volume Size"
+  description = <<-EOF
+  How large should your home volume be?
+  EOF
+  type        = "number"
+  default     = 30
+  mutable     = true
+  order       = 3
+
+  option {
+    name  = "30GB"
+    value = 30
+  }
+
+  option {
+    name  = "60GB"
+    value = 60
+  }
+
+  option {
+    name  = "100GB"
+    value = 100
+  }
+
+  validation {
+    monotonic = "increasing"
+  }
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema