diff --git a/docs/examples/creating-a-standardised-space-and-project.md b/docs/examples/creating-a-standardised-space-and-project.md new file mode 100644 index 000000000..72f4d3708 --- /dev/null +++ b/docs/examples/creating-a-standardised-space-and-project.md @@ -0,0 +1,9 @@ +--- +page_title: "Creating a Standardised Space and Project" +subcategory: "Examples" +--- + +# Creating a Standardised Space and Project + +This example show how to create a standardised space and project that can be used to quickly setup applications used as +microservices. diff --git a/templates/guides/4-create-multiple-resources.md.tmpl b/docs/guides/create-multiple-resources.md similarity index 95% rename from templates/guides/4-create-multiple-resources.md.tmpl rename to docs/guides/create-multiple-resources.md index 3fd1c81bf..01fe57b36 100644 --- a/templates/guides/4-create-multiple-resources.md.tmpl +++ b/docs/guides/create-multiple-resources.md @@ -1,11 +1,11 @@ --- -page_title: "4. Creating Multiple Resources" +page_title: "Creating Multiple Resources" subcategory: "Guides" --- -# 4. Creating multiple Octopus Deploy resources +# Creating multiple Octopus Deploy resources -In step 3, you learned about creating one resource. In this step we will create multiple resources with the same Terraform config file. +In Creating a Resource guide, you learned about creating one resource. In this guide we will create multiple resources with the same Terraform config file. The below Terraform configuration will create the following Octopus Deploy resources: * Environment diff --git a/docs/guides/3-create-resource.md b/docs/guides/create-resource.md similarity index 95% rename from docs/guides/3-create-resource.md rename to docs/guides/create-resource.md index e58d46f9a..959265ccb 100644 --- a/docs/guides/3-create-resource.md +++ b/docs/guides/create-resource.md @@ -1,9 +1,9 @@ --- -page_title: "3. Creating a Resource" +page_title: "Creating a Resource" subcategory: "Guides" --- -# 3. Creating your first Octopus Deploy resource +# Creating your first Octopus Deploy resource ## Provider Setup diff --git a/docs/guides/how-to-find-step-properties.md b/docs/guides/how-to-find-step-properties.md new file mode 100644 index 000000000..29d792024 --- /dev/null +++ b/docs/guides/how-to-find-step-properties.md @@ -0,0 +1,24 @@ +--- +page_title: "How to Find Step Properties" +subcategory: "Guides" +--- + +# How to Find Step Properties + +When defining step properties for a deployment or runbook process it can be challenging to discover the required key and +values for a step. This guides goal is to help with the discovery of step properties. + +To discover properties for a step its best to first define deployment process within the UI including the steps you wish +to use within the provider. Once the deployment process is defined and the step are configured do the following: + +1. Click the ellipsis to the right of the `save` button on the Process Editor page +1. From the menu select `Download as JSON` +1. Open the downloaded JSON file in an editor of your choice +1. Within the JSON you will find a key `Steps`, this is an array of step objects. The objects are in the run order. +1. Locate the key `Properties` within a step object, this maps to the key/value pairs for the `properties` field on the `process_step` resource in HCL. +1. Locate the key `Actions` within a step object, this is and array of actions. Every Step object will have at lest one action, the first action is always related to the step object while additional actions are used to define child steps. +1. Locate the key `Properties` within the first action object of the array, this maps the key/value pairs for the `execution_properties` field on the `process_step` resource in HCL. +1. The following action objects within the array, if any, will map to the `property` key to the `execution_properties` field on the `process_child_step` resource within HCL. + + +Note that in the future we plan to improve the discoverability of step properties. diff --git a/templates/guides/2-provider-configuration.md.tmpl b/docs/guides/provider-configuration.md similarity index 95% rename from templates/guides/2-provider-configuration.md.tmpl rename to docs/guides/provider-configuration.md index 94deaf8af..6b7fec4c9 100644 --- a/templates/guides/2-provider-configuration.md.tmpl +++ b/docs/guides/provider-configuration.md @@ -1,9 +1,9 @@ --- -page_title: "2. Octopus Deploy Provider Configuration" +page_title: "Octopus Deploy Provider Configuration" subcategory: "Guides" --- -# 2. Octopus Deploy Provider Configuration +# Octopus Deploy Provider Configuration ## Example usage diff --git a/docs/guides/1-terraform.md b/docs/guides/why-terraform.md similarity index 97% rename from docs/guides/1-terraform.md rename to docs/guides/why-terraform.md index 31a700d20..916299e2c 100644 --- a/docs/guides/1-terraform.md +++ b/docs/guides/why-terraform.md @@ -1,9 +1,9 @@ --- -page_title: "1. Why Terraform?" +page_title: "Why Terraform?" subcategory: "Guides" --- -# 1. Why Terraform? +# Why Terraform? If you're new to Terraform in general, it may be in your best interest to start with some Terraform Getting Started Docs. diff --git a/docs/resources/aws_openid_connect_account.md b/docs/resources/aws_openid_connect_account.md index 03301f13f..c8714e690 100644 --- a/docs/resources/aws_openid_connect_account.md +++ b/docs/resources/aws_openid_connect_account.md @@ -1,5 +1,4 @@ --- -# generated by https://github.com/hashicorp/terraform-plugin-docs page_title: "octopusdeploy_aws_openid_connect_account Resource - terraform-provider-octopusdeploy" subcategory: "" description: |- @@ -10,7 +9,19 @@ description: |- This resource manages AWS OIDC accounts in Octopus Deploy. - +## Example Usage + +```terraform +resource "octopusdeploy_aws_openid_connect_account" "example" { + name = "AWS OIDC Account" + description = "AWS OIDC Connect Account" + role_arn = "Amazon Resource Name" + account_test_subject_keys = ["space"] + environments = ["environment-123"] + tenants = ["tenants-123"] + execution_subject_keys = ["space"] +} +``` ## Schema diff --git a/docs/resources/library_variable_set.md b/docs/resources/library_variable_set.md index 46bdfca29..b9483d3fc 100644 --- a/docs/resources/library_variable_set.md +++ b/docs/resources/library_variable_set.md @@ -1,5 +1,4 @@ --- -# generated by https://github.com/hashicorp/terraform-plugin-docs page_title: "octopusdeploy_library_variable_set Resource - terraform-provider-octopusdeploy" subcategory: "" description: |- @@ -10,43 +9,10 @@ description: |- This resource manages library variable sets in Octopus Deploy. +## Import +Import is supported using the following syntax: - -## Schema - -### Required - -- `name` (String) The name of this resource. - -### Optional - -- `description` (String) The description of this library variable set. -- `space_id` (String) The space ID associated with this library variable set. -- `template` (Block List) (see [below for nested schema](#nestedblock--template)) - -### Read-Only - -- `id` (String) The unique ID for this resource. -- `template_ids` (Map of String) -- `variable_set_id` (String) - - -### Nested Schema for `template` - -Required: - -- `name` (String) The name of the variable set by the parameter. The name can contain letters, digits, dashes and periods. Example: `ServerName` - -Optional: - -- `default_value` (String) A default value for the parameter, if applicable. This can be a hard-coded value or a variable reference. -- `display_settings` (Map of String) The display settings for the parameter. -- `help_text` (String) The help presented alongside the parameter input. -- `label` (String) The label shown beside the parameter when presented in the deployment process. Example: `Server name`. - -Read-Only: - -- `id` (String) The unique ID for this resource. - - +```shell +terraform import [options] octopusdeploy_library_variable_set. +``` diff --git a/docs/resources/process_step.md b/docs/resources/process_step.md index 420640ec2..61f75af88 100644 --- a/docs/resources/process_step.md +++ b/docs/resources/process_step.md @@ -21,6 +21,8 @@ This resource also contains a concept that doesn't exist in the Octopus Deploy d * `properties` are the inputs to the step itself * `execution_properties` are the controls for _how_ the step runs, particularly relevant in parent/child step situations +For more information on how to discover step properties read the *How to Find Step Properties* under the guides section of the documentation. + ## Example Usage ```terraform diff --git a/docs/resources/process_templated_child_step.md b/docs/resources/process_templated_child_step.md index 032de201c..dd817636f 100644 --- a/docs/resources/process_templated_child_step.md +++ b/docs/resources/process_templated_child_step.md @@ -10,7 +10,9 @@ description: |- This resource manages a child step of a Runbook or Deployment process which based on existing custom step template ### Remarks -This resource exposes only attributes which can be controlled by the consumer of a template. +This resource exposes only attributes which can be controlled by the consumer of a template. + +For more information on how to discover step properties read the *How to Find Step Properties* under the guides section of the documentation. ## Example Usage diff --git a/docs/resources/tenant_project.md b/docs/resources/tenant_project.md index 089ddc20c..8b0cdab31 100644 --- a/docs/resources/tenant_project.md +++ b/docs/resources/tenant_project.md @@ -1,5 +1,4 @@ --- -# generated by https://github.com/hashicorp/terraform-plugin-docs page_title: "octopusdeploy_tenant_project Resource - terraform-provider-octopusdeploy" subcategory: "" description: |- @@ -10,7 +9,17 @@ description: |- +## Example Usage +```terraform +resource "octopusdeploy_tenant_project" "example" { + project_id = "project-123" + tenant_id = "tenant-123" + environment_ids = [ + "environment-123" + ] +} +``` ## Schema @@ -29,4 +38,10 @@ description: |- - `id` (String) The unique ID for this resource. +## Import +Import is supported using the following syntax: + +```shell +terraform import [options] octopusdeploy_tenant_project. +``` diff --git a/docs/resources/tenant_project_variable.md b/docs/resources/tenant_project_variable.md index 053b6739a..2c65a5494 100644 --- a/docs/resources/tenant_project_variable.md +++ b/docs/resources/tenant_project_variable.md @@ -1,5 +1,4 @@ --- -# generated by https://github.com/hashicorp/terraform-plugin-docs page_title: "octopusdeploy_tenant_project_variable Resource - terraform-provider-octopusdeploy" subcategory: "" description: |- @@ -10,7 +9,17 @@ description: |- Manages a tenant project variable in Octopus Deploy. +## Example Usage +```terraform +resource "octopusdeploy_tenant_project_variable" "example" { + environment_id = "environment-123" + project_id = "project-123" + template_id = "template-123" + tenant_id = "tenant-123" + value = "my-tenant-project-variable-value" +} +``` ## Schema @@ -31,4 +40,10 @@ Manages a tenant project variable in Octopus Deploy. - `id` (String) The unique ID for this resource. +## Import +Import is supported using the following syntax: + +```shell +terraform import [options] octopusdeploy_tanant_project_variable. +``` diff --git a/docs/guides/migration-guide-v0.37.1.md b/docs/upgrades-and-migrations/migration-guide-v0.37.1.md similarity index 100% rename from docs/guides/migration-guide-v0.37.1.md rename to docs/upgrades-and-migrations/migration-guide-v0.37.1.md diff --git a/docs/guides/migration-guide-v0.8.0.md b/docs/upgrades-and-migrations/migration-guide-v0.8.0.md similarity index 100% rename from docs/guides/migration-guide-v0.8.0.md rename to docs/upgrades-and-migrations/migration-guide-v0.8.0.md diff --git a/docs/guides/migration-guide-v1.0.0.md b/docs/upgrades-and-migrations/migration-guide-v1.0.0.md similarity index 100% rename from docs/guides/migration-guide-v1.0.0.md rename to docs/upgrades-and-migrations/migration-guide-v1.0.0.md diff --git a/examples/resources/octopusdeploy_aws_openid_connect_account/resource.tf b/examples/resources/octopusdeploy_aws_openid_connect_account/resource.tf new file mode 100644 index 000000000..265cb066d --- /dev/null +++ b/examples/resources/octopusdeploy_aws_openid_connect_account/resource.tf @@ -0,0 +1,9 @@ +resource "octopusdeploy_aws_openid_connect_account" "example" { + name = "AWS OIDC Account" + description = "AWS OIDC Connect Account" + role_arn = "Amazon Resource Name" + account_test_subject_keys = ["space"] + environments = ["environment-123"] + tenants = ["tenants-123"] + execution_subject_keys = ["space"] +} \ No newline at end of file diff --git a/examples/resources/octopusdeploy_library_variable_set/import.sh b/examples/resources/octopusdeploy_library_variable_set/import.sh new file mode 100644 index 000000000..10a298dfd --- /dev/null +++ b/examples/resources/octopusdeploy_library_variable_set/import.sh @@ -0,0 +1 @@ +terraform import [options] octopusdeploy_library_variable_set. diff --git a/examples/resources/octopusdeploy_tenant_project/import.sh b/examples/resources/octopusdeploy_tenant_project/import.sh new file mode 100644 index 000000000..1a352d513 --- /dev/null +++ b/examples/resources/octopusdeploy_tenant_project/import.sh @@ -0,0 +1 @@ +terraform import [options] octopusdeploy_tenant_project. diff --git a/examples/resources/octopusdeploy_tenant_project/resource.tf b/examples/resources/octopusdeploy_tenant_project/resource.tf new file mode 100644 index 000000000..bb5b1cf63 --- /dev/null +++ b/examples/resources/octopusdeploy_tenant_project/resource.tf @@ -0,0 +1,7 @@ +resource "octopusdeploy_tenant_project" "example" { + project_id = "project-123" + tenant_id = "tenant-123" + environment_ids = [ + "environment-123" + ] +} \ No newline at end of file diff --git a/examples/resources/octopusdeploy_tenant_project_variable/import.sh b/examples/resources/octopusdeploy_tenant_project_variable/import.sh new file mode 100644 index 000000000..4b5ac0d8d --- /dev/null +++ b/examples/resources/octopusdeploy_tenant_project_variable/import.sh @@ -0,0 +1 @@ +terraform import [options] octopusdeploy_tanant_project_variable. diff --git a/examples/resources/octopusdeploy_tenant_project_variable/resource.tf b/examples/resources/octopusdeploy_tenant_project_variable/resource.tf new file mode 100644 index 000000000..ea87ce5b8 --- /dev/null +++ b/examples/resources/octopusdeploy_tenant_project_variable/resource.tf @@ -0,0 +1,7 @@ +resource "octopusdeploy_tenant_project_variable" "example" { + environment_id = "environment-123" + project_id = "project-123" + template_id = "template-123" + tenant_id = "tenant-123" + value = "my-tenant-project-variable-value" +} \ No newline at end of file diff --git a/templates/examples/creating-a-standardised-space-and-project.md.tmpl b/templates/examples/creating-a-standardised-space-and-project.md.tmpl new file mode 100644 index 000000000..72f4d3708 --- /dev/null +++ b/templates/examples/creating-a-standardised-space-and-project.md.tmpl @@ -0,0 +1,9 @@ +--- +page_title: "Creating a Standardised Space and Project" +subcategory: "Examples" +--- + +# Creating a Standardised Space and Project + +This example show how to create a standardised space and project that can be used to quickly setup applications used as +microservices. diff --git a/docs/guides/4-create-multiple-resources.md b/templates/guides/create-multiple-resources.md.tmpl similarity index 95% rename from docs/guides/4-create-multiple-resources.md rename to templates/guides/create-multiple-resources.md.tmpl index 3fd1c81bf..01fe57b36 100644 --- a/docs/guides/4-create-multiple-resources.md +++ b/templates/guides/create-multiple-resources.md.tmpl @@ -1,11 +1,11 @@ --- -page_title: "4. Creating Multiple Resources" +page_title: "Creating Multiple Resources" subcategory: "Guides" --- -# 4. Creating multiple Octopus Deploy resources +# Creating multiple Octopus Deploy resources -In step 3, you learned about creating one resource. In this step we will create multiple resources with the same Terraform config file. +In Creating a Resource guide, you learned about creating one resource. In this guide we will create multiple resources with the same Terraform config file. The below Terraform configuration will create the following Octopus Deploy resources: * Environment diff --git a/templates/guides/3-create-resource.md.tmpl b/templates/guides/create-resource.md.tmpl similarity index 95% rename from templates/guides/3-create-resource.md.tmpl rename to templates/guides/create-resource.md.tmpl index e58d46f9a..959265ccb 100644 --- a/templates/guides/3-create-resource.md.tmpl +++ b/templates/guides/create-resource.md.tmpl @@ -1,9 +1,9 @@ --- -page_title: "3. Creating a Resource" +page_title: "Creating a Resource" subcategory: "Guides" --- -# 3. Creating your first Octopus Deploy resource +# Creating your first Octopus Deploy resource ## Provider Setup diff --git a/templates/guides/how-to-find-step-properties.md.tmpl b/templates/guides/how-to-find-step-properties.md.tmpl new file mode 100644 index 000000000..29d792024 --- /dev/null +++ b/templates/guides/how-to-find-step-properties.md.tmpl @@ -0,0 +1,24 @@ +--- +page_title: "How to Find Step Properties" +subcategory: "Guides" +--- + +# How to Find Step Properties + +When defining step properties for a deployment or runbook process it can be challenging to discover the required key and +values for a step. This guides goal is to help with the discovery of step properties. + +To discover properties for a step its best to first define deployment process within the UI including the steps you wish +to use within the provider. Once the deployment process is defined and the step are configured do the following: + +1. Click the ellipsis to the right of the `save` button on the Process Editor page +1. From the menu select `Download as JSON` +1. Open the downloaded JSON file in an editor of your choice +1. Within the JSON you will find a key `Steps`, this is an array of step objects. The objects are in the run order. +1. Locate the key `Properties` within a step object, this maps to the key/value pairs for the `properties` field on the `process_step` resource in HCL. +1. Locate the key `Actions` within a step object, this is and array of actions. Every Step object will have at lest one action, the first action is always related to the step object while additional actions are used to define child steps. +1. Locate the key `Properties` within the first action object of the array, this maps the key/value pairs for the `execution_properties` field on the `process_step` resource in HCL. +1. The following action objects within the array, if any, will map to the `property` key to the `execution_properties` field on the `process_child_step` resource within HCL. + + +Note that in the future we plan to improve the discoverability of step properties. diff --git a/docs/guides/2-provider-configuration.md b/templates/guides/provider-configuration.md.tmpl similarity index 95% rename from docs/guides/2-provider-configuration.md rename to templates/guides/provider-configuration.md.tmpl index 94deaf8af..6b7fec4c9 100644 --- a/docs/guides/2-provider-configuration.md +++ b/templates/guides/provider-configuration.md.tmpl @@ -1,9 +1,9 @@ --- -page_title: "2. Octopus Deploy Provider Configuration" +page_title: "Octopus Deploy Provider Configuration" subcategory: "Guides" --- -# 2. Octopus Deploy Provider Configuration +# Octopus Deploy Provider Configuration ## Example usage diff --git a/templates/guides/1-terraform.md.tmpl b/templates/guides/why-terraform.md.tmpl similarity index 97% rename from templates/guides/1-terraform.md.tmpl rename to templates/guides/why-terraform.md.tmpl index 31a700d20..916299e2c 100644 --- a/templates/guides/1-terraform.md.tmpl +++ b/templates/guides/why-terraform.md.tmpl @@ -1,9 +1,9 @@ --- -page_title: "1. Why Terraform?" +page_title: "Why Terraform?" subcategory: "Guides" --- -# 1. Why Terraform? +# Why Terraform? If you're new to Terraform in general, it may be in your best interest to start with some Terraform Getting Started Docs. diff --git a/templates/resources/aws_openid_connect_account.md.tmpl b/templates/resources/aws_openid_connect_account.md.tmpl new file mode 100644 index 000000000..caa8d12a9 --- /dev/null +++ b/templates/resources/aws_openid_connect_account.md.tmpl @@ -0,0 +1,24 @@ +--- +page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}" +subcategory: "" +description: |- +{{ .Description | plainmarkdown | trimspace | prefixlines " " }} +--- + +# {{.Name}} ({{.Type}}) + +{{ .Description | trimspace }} + +## Example Usage + +{{ tffile (printf "%s%s%s" "examples/resources/" .Name "/resource.tf") }} + +{{ .SchemaMarkdown | trimspace }} + +{{ if .HasImport -}} +## Import + +Import is supported using the following syntax: + +{{ codefile "shell" (printf "%s%s%s" "examples/resources/" .Name "/import.sh") }} +{{- end }} diff --git a/templates/resources/library_variable_set.md.tmpl b/templates/resources/library_variable_set.md.tmpl new file mode 100644 index 000000000..e8fd502f8 --- /dev/null +++ b/templates/resources/library_variable_set.md.tmpl @@ -0,0 +1,18 @@ +--- +page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}" +subcategory: "" +description: |- +{{ .Description | plainmarkdown | trimspace | prefixlines " " }} +--- + +# {{.Name}} ({{.Type}}) + +{{ .Description | trimspace }} + +{{ if .HasImport -}} +## Import + +Import is supported using the following syntax: + +{{ codefile "shell" (printf "%s%s%s" "examples/resources/" .Name "/import.sh") }} +{{- end }} diff --git a/templates/resources/process_step.md.tmpl b/templates/resources/process_step.md.tmpl index ea93dfa30..f404af64a 100644 --- a/templates/resources/process_step.md.tmpl +++ b/templates/resources/process_step.md.tmpl @@ -21,6 +21,8 @@ This resource also contains a concept that doesn't exist in the Octopus Deploy d * `properties` are the inputs to the step itself * `execution_properties` are the controls for _how_ the step runs, particularly relevant in parent/child step situations +For more information on how to discover step properties read the *How to Find Step Properties* under the guides section of the documentation. + ## Example Usage {{ tffile (printf "%s%s%s" "examples/resources/" .Name "/resource.tf") }} diff --git a/templates/resources/process_templated_child_step.md.tmpl b/templates/resources/process_templated_child_step.md.tmpl index 56b46a9e6..e6bd6db27 100644 --- a/templates/resources/process_templated_child_step.md.tmpl +++ b/templates/resources/process_templated_child_step.md.tmpl @@ -10,7 +10,9 @@ description: |- {{ .Description | trimspace }} ### Remarks -This resource exposes only attributes which can be controlled by the consumer of a template. +This resource exposes only attributes which can be controlled by the consumer of a template. + +For more information on how to discover step properties read the *How to Find Step Properties* under the guides section of the documentation. ## Example Usage diff --git a/templates/resources/tenant_project.md.tmpl b/templates/resources/tenant_project.md.tmpl new file mode 100644 index 000000000..caa8d12a9 --- /dev/null +++ b/templates/resources/tenant_project.md.tmpl @@ -0,0 +1,24 @@ +--- +page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}" +subcategory: "" +description: |- +{{ .Description | plainmarkdown | trimspace | prefixlines " " }} +--- + +# {{.Name}} ({{.Type}}) + +{{ .Description | trimspace }} + +## Example Usage + +{{ tffile (printf "%s%s%s" "examples/resources/" .Name "/resource.tf") }} + +{{ .SchemaMarkdown | trimspace }} + +{{ if .HasImport -}} +## Import + +Import is supported using the following syntax: + +{{ codefile "shell" (printf "%s%s%s" "examples/resources/" .Name "/import.sh") }} +{{- end }} diff --git a/templates/resources/tenant_project_variable.md.tmpl b/templates/resources/tenant_project_variable.md.tmpl new file mode 100644 index 000000000..caa8d12a9 --- /dev/null +++ b/templates/resources/tenant_project_variable.md.tmpl @@ -0,0 +1,24 @@ +--- +page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}" +subcategory: "" +description: |- +{{ .Description | plainmarkdown | trimspace | prefixlines " " }} +--- + +# {{.Name}} ({{.Type}}) + +{{ .Description | trimspace }} + +## Example Usage + +{{ tffile (printf "%s%s%s" "examples/resources/" .Name "/resource.tf") }} + +{{ .SchemaMarkdown | trimspace }} + +{{ if .HasImport -}} +## Import + +Import is supported using the following syntax: + +{{ codefile "shell" (printf "%s%s%s" "examples/resources/" .Name "/import.sh") }} +{{- end }} diff --git a/templates/guides/migration-guide-v0.37.1.md.tmpl b/templates/upgrades-and-migrations/migration-guide-v0.37.1.md.tmpl similarity index 100% rename from templates/guides/migration-guide-v0.37.1.md.tmpl rename to templates/upgrades-and-migrations/migration-guide-v0.37.1.md.tmpl diff --git a/templates/guides/migration-guide-v0.8.0.md.tmpl b/templates/upgrades-and-migrations/migration-guide-v0.8.0.md.tmpl similarity index 100% rename from templates/guides/migration-guide-v0.8.0.md.tmpl rename to templates/upgrades-and-migrations/migration-guide-v0.8.0.md.tmpl diff --git a/templates/guides/migration-guide-v1.0.0.md.tmpl b/templates/upgrades-and-migrations/migration-guide-v1.0.0.md.tmpl similarity index 100% rename from templates/guides/migration-guide-v1.0.0.md.tmpl rename to templates/upgrades-and-migrations/migration-guide-v1.0.0.md.tmpl