From 9ca6d562a87935737d103fc56784c3e1cd4011bb Mon Sep 17 00:00:00 2001
From: Danny Cartagena <dancrta@amazon.com>
Date: Tue, 13 Aug 2024 11:34:31 -0500
Subject: [PATCH] docs : add example for
 awscc_stepfunctions_state_machine_version

---
 .../stepfunctions_state_machine_version.md    | 48 ++++++++++++++++++-
 .../stepfunctions_state_machine_version.tf    | 44 +++++++++++++++++
 ...tepfunctions_state_machine_version.md.tmpl | 25 ++++++++++
 3 files changed, 116 insertions(+), 1 deletion(-)
 create mode 100644 examples/resources/awscc_stepfunctions_state_machine_version/stepfunctions_state_machine_version.tf
 create mode 100644 templates/resources/stepfunctions_state_machine_version.md.tmpl

diff --git a/docs/resources/stepfunctions_state_machine_version.md b/docs/resources/stepfunctions_state_machine_version.md
index 193399652..fab72177e 100644
--- a/docs/resources/stepfunctions_state_machine_version.md
+++ b/docs/resources/stepfunctions_state_machine_version.md
@@ -1,5 +1,4 @@
 ---
-# generated by https://github.com/hashicorp/terraform-plugin-docs
 page_title: "awscc_stepfunctions_state_machine_version Resource - terraform-provider-awscc"
 subcategory: ""
 description: |-
@@ -10,7 +9,54 @@ description: |-
 
 Resource schema for StateMachineVersion
 
+## Example Usage
+In this example, we create a version of a state machine. The example includes the necessary code to create a basic state machine.
+```terraform
+resource "awscc_iam_role" "main" {
+  description = "AWS IAM role for a step function"
+  assume_role_policy_document = jsonencode({
+    Version = "2012-10-17"
+    Statement = [
+      {
+        Action = "sts:AssumeRole"
+        Effect = "Allow"
+        Sid    = ""
+        Principal = {
+          Service = "states.amazonaws.com"
+        }
+      },
+    ]
+  })
+}
 
+resource "awscc_stepfunctions_state_machine" "sfn_stepmachine" {
+  role_arn           = awscc_iam_role.main.arn
+  state_machine_type = "STANDARD"
+  definition_string  = <<EOT
+    {
+      "StartAt": "FirstState",
+      "States": {
+        "FirstState": {
+          "Type": "Pass",
+          "Result": "Hello World!",
+          "End": true
+        }
+      }
+    }
+  EOT
+  tags = [
+    {
+      key   = "Modified By"
+      value = "AWSCC"
+    }
+  ]
+}
+
+resource "awscc_stepfunctions_state_machine_version" "version" {
+  description = "State machine version description"
+  state_machine_arn = awscc_stepfunctions_state_machine.sfn_stepmachine.arn
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
diff --git a/examples/resources/awscc_stepfunctions_state_machine_version/stepfunctions_state_machine_version.tf b/examples/resources/awscc_stepfunctions_state_machine_version/stepfunctions_state_machine_version.tf
new file mode 100644
index 000000000..adeb3dec2
--- /dev/null
+++ b/examples/resources/awscc_stepfunctions_state_machine_version/stepfunctions_state_machine_version.tf
@@ -0,0 +1,44 @@
+resource "awscc_iam_role" "main" {
+  description = "AWS IAM role for a step function"
+  assume_role_policy_document = jsonencode({
+    Version = "2012-10-17"
+    Statement = [
+      {
+        Action = "sts:AssumeRole"
+        Effect = "Allow"
+        Sid    = ""
+        Principal = {
+          Service = "states.amazonaws.com"
+        }
+      },
+    ]
+  })
+}
+
+resource "awscc_stepfunctions_state_machine" "sfn_stepmachine" {
+  role_arn           = awscc_iam_role.main.arn
+  state_machine_type = "STANDARD"
+  definition_string  = <<EOT
+    {
+      "StartAt": "FirstState",
+      "States": {
+        "FirstState": {
+          "Type": "Pass",
+          "Result": "Hello World!",
+          "End": true
+        }
+      }
+    }
+  EOT
+  tags = [
+    {
+      key   = "Modified By"
+      value = "AWSCC"
+    }
+  ]
+}
+
+resource "awscc_stepfunctions_state_machine_version" "version" {
+  description = "State machine version description"
+  state_machine_arn = awscc_stepfunctions_state_machine.sfn_stepmachine.arn
+}
\ No newline at end of file
diff --git a/templates/resources/stepfunctions_state_machine_version.md.tmpl b/templates/resources/stepfunctions_state_machine_version.md.tmpl
new file mode 100644
index 000000000..22a40e2a6
--- /dev/null
+++ b/templates/resources/stepfunctions_state_machine_version.md.tmpl
@@ -0,0 +1,25 @@
+---
+page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+In this example, we create a version of a state machine. The example includes the necessary code to create a basic state machine.
+{{ tffile (printf "examples/resources/%s/stepfunctions_state_machine_version.tf" .Name)}}
+
+{{ .SchemaMarkdown | trimspace }}
+{{- if .HasImport }}
+
+## Import
+
+Import is supported using the following syntax:
+
+{{ codefile "shell" .ImportFile }}
+
+{{- end }}