added external auth link, make gen

Author: stirby

docs/data-sources/external_auth.md

@@ -3,14 +3,28 @@
 page_title: "coder_external_auth Data Source - terraform-provider-coder"
 subcategory: ""
 description: |-
-  Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to pre-authenticate external services in a workspace. (e.g. gcloud, gh, docker, etc)
+  Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to pre-authenticate external services https://coder.com/docs/admin/external-auth in a workspace. (e.g. Google Cloud, Github, Docker, etc.)
 ---
 
 # coder_external_auth (Data Source)
 
-Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to pre-authenticate external services in a workspace. (e.g. gcloud, gh, docker, etc)
+Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to [pre-authenticate external services](https://coder.com/docs/admin/external-auth) in a workspace. (e.g. Google Cloud, Github, Docker, etc.)
 
+## Example Usage
 
+```terraform
+provider "coder" {}
+
+
+data "coder_external_auth" "github" {
+  id = "github"
+}
+
+data "coder_external_auth" "azure-identity" {
+  id       = "azure-identiy"
+  optional = true
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/env.md

@@ -10,7 +10,29 @@ description: |-
 
 Use this resource to set an environment variable in a workspace. Note that this resource cannot be used to overwrite existing environment variables set on the "coder_agent" resource.
 
-
+## Example Usage
+
+```terraform
+data "coder_workspace" "me" {}
+
+resource "coder_agent" "dev" {
+  os   = "linux"
+  arch = "amd64"
+  dir  = "/workspace"
+}
+
+resource "coder_env" "welcome_message" {
+  agent_id = coder_agent.dev.id
+  name     = "WELCOME_MESSAGE"
+  value    = "Welcome to your Coder workspace!"
+}
+
+resource "coder_env" "internal_api_url" {
+  agent_id = coder_agent.dev.id
+  name     = "INTERNAL_API_URL"
+  value    = "https://api.internal.company.com/v1"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/script.md

@@ -3,14 +3,69 @@
 page_title: "coder_script Resource - terraform-provider-coder"
 subcategory: ""
 description: |-
-  Use this resource to run a script from an agent.
+  Use this resource to run a script from an agent. When multiple scripts are assigned to the same agent, they are executed in parallel.
 ---
 
 # coder_script (Resource)
 
-Use this resource to run a script from an agent.
+Use this resource to run a script from an agent. When multiple scripts are assigned to the same agent, they are executed in parallel.
 
+## Example Usage
 
+```terraform
+data "coder_workspace" "me" {}
+
+resource "coder_agent" "dev" {
+  os   = "linux"
+  arch = "amd64"
+  dir  = "/workspace"
+}
+
+resource "coder_script" "dotfiles" {
+  agent_id     = coder_agent.dev.agent_id
+  display_name = "Dotfiles"
+  icon         = "/icon/dotfiles.svg"
+  run_on_start = true
+  script = templatefile("~/get_dotfiles.sh", {
+    DOTFILES_URI : var.dotfiles_uri,
+    DOTFILES_USER : var.dotfiles_user
+  })
+}
+
+resource "coder_script" "code-server" {
+  agent_id           = coder_agent.dev.agent_id
+  display_name       = "code-server"
+  icon               = "/icon/code.svg"
+  run_on_start       = true
+  start_blocks_login = true
+  script = templatefile("./install-code-server.sh", {
+    LOG_PATH : "/tmp/code-server.log"
+  })
+}
+
+resource "coder_script" "nightly_sleep_reminder" {
+  agent_id     = coder_agent.dev.agent_id
+  display_name = "Nightly update"
+  icon         = "/icon/database.svg"
+  cron         = "0 22 * * *"
+  script       = <<EOF
+    #!/bin/sh
+    echo "Running nightly update"
+    sudo apt-get install
+  EOF
+}
+
+resource "coder_script" "shutdown" {
+  agent_id     = coder_agent.dev.id
+  display_name = "Stop daemon server"
+  run_on_stop  = true
+  icon         = "/icons/memory.svg"
+  script       = <<EOF
+    #!/bin/sh 
+    kill $(lsof -i :3002 -t) >/tmp/pid.log 2>&1 &
+  EOF
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

provider/externalauth.go

@@ -15,7 +15,7 @@ func externalAuthDataSource() *schema.Resource {
 	return &schema.Resource{
 		SchemaVersion: 1,
 
-		Description: "Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to pre-authenticate external services in a workspace. (e.g. gcloud, gh, docker, etc)",
+		Description: "Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to [pre-authenticate external services](https://coder.com/docs/admin/external-auth) in a workspace. (e.g. Google Cloud, Github, Docker, etc.)",
 		ReadContext: func(ctx context.Context, rd *schema.ResourceData, i interface{}) diag.Diagnostics {
 			id, ok := rd.Get("id").(string)
 			if !ok || id == "" {