From b7d3b099a4fa7f02a36b8ce3310655a62800ff14 Mon Sep 17 00:00:00 2001
From: trujillo-adam <ajosetru@gmail.com>
Date: Thu, 15 May 2025 11:41:50 -0700
Subject: [PATCH 1/2] fixes a few mistakes in the resource block ref

---
 website/docs/language/block/resource.mdx | 71 +++++++++++++++++++++++-
 1 file changed, 68 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index e0a695ec06e8..8ba31f32defe 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -59,7 +59,7 @@ The `resource` block supports the following arguments:
         - [`proxy_port`](#connection-arguments) &nbsp; string
         - [`proxy_user_name`](#connection-arguments) &nbsp; string
         - [`proxy_user_password`](#connection-arguments) &nbsp; string
-   - [`provisioner "<TYPE>" "<LABEL>"`](#provisioner) &nbsp; block
+   - [`provisioner "<TYPE>"`](#provisioner) &nbsp; block
       - [`source`](#source) &nbsp; string
       - [`destination`](#destination) &nbsp; string
       - [`content`](#content) &nbsp; string      
@@ -111,7 +111,7 @@ resource "<TYPE>" "<LABEL>" {
     host = <EXPRESSION>
     <DEFAULT_CONNECTION_SETTINGS>
   }
-  provisioner "<TYPE>" "<LABEL>" {
+  provisioner "<TYPE>" {
     source = "<PATH>"
     destination = "<PATH>"
     content = "<CONTENT TO COPY TO `destination`>"
@@ -597,7 +597,7 @@ The `provisioner` block defines actions to perform on the local machine or creat
 
 ```hcl
 resource {
-  provisioner "<TYPE>" "<LABEL>" {
+  provisioner "<TYPE>" {
     <arguments> 
   }
 }
@@ -719,6 +719,7 @@ Modern Windows systems support running an OpenSSH server, so we strongly recomme
 ### `command`
 
 The `command` argument specifies a command for a local executable to run. You can specify an absolute path or a relative path to the current working directory. 
+
 ```hcl
 resource {
   provisioner "local-exec" "<LABEL>" {
@@ -837,6 +838,70 @@ When `quiet` is set to `true`, Terraform prints `"Suppressed by quiet=true"` to
 - Data type: Boolean.
 - Default: None.
 
+
+### `inline` 
+
+Specifies a list of command strings for the remote resource to run.
+
+
+```hcl
+resource {
+  # ...
+  provisioner "remote-exec" {
+    inline = [ "<command>" ]
+  }
+}
+```
+The provisioner uses the remote resource's default shell unless you specify a shell as the first command, for example `#!/bin/bash`. You cannot add an `inline` argument in the same provisioner with `script` or `scripts`.
+
+#### Summary
+
+- Data type: List.
+- Default: None.
+
+### `script`
+
+Specifies the relative or absolute path to a script on the local machine to copy and execute on the remote resource.  
+
+
+```hcl
+resource {
+  # ...
+  provisioner "remote-exec" {
+    scripts = "<path-to-script>"
+  }
+}
+```
+
+You cannot add a `script` argument in the same provisioner with `inline` or `scripts`.
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+
+### `scripts`
+
+Specifies a list of relative or absolute paths to scripts on the local machine to copy and execute on the remote resource.  
+
+
+```hcl
+resource {
+  # ...
+  provisioner "remote-exec" {
+    scripts = [ "<path-to-script>" ]
+  }
+}
+```
+
+You cannot add a `scripts` argument in the same provisioner with `inline` or `script`.
+
+#### Summary
+
+- Data type: List.
+- Default: None.
+
+
 ## Examples
 
 The following examples show how to write configuration for common use cases.

From fe37cf1a990a1fbcc30bb00edce52c78eed20b99 Mon Sep 17 00:00:00 2001
From: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
Date: Mon, 19 May 2025 12:56:19 -0700
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: rita <8647768+ritsok@users.noreply.github.com>
---
 website/docs/language/block/resource.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index 8ba31f32defe..3dccd07704aa 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -841,7 +841,7 @@ When `quiet` is set to `true`, Terraform prints `"Suppressed by quiet=true"` to
 
 ### `inline` 
 
-Specifies a list of command strings for the remote resource to run.
+Specifies a list of command strings to execute on the remote resource.
 
 
 ```hcl
@@ -882,7 +882,7 @@ You cannot add a `script` argument in the same provisioner with `inline` or `scr
 
 ### `scripts`
 
-Specifies a list of relative or absolute paths to scripts on the local machine to copy and execute on the remote resource.  
+Specifies a list of relative or absolute paths to script files on the local machine to copy and execute on the remote resource.  
 
 
 ```hcl