Add examples for the resources that support Terraform import.

docs/resources/artifact_store.md

@@ -25,6 +25,17 @@ resource "gocd_artifact_store" "docker" {
 }
 ```
 
+## Importing the existing GoCD artifact store to Terraform State
+```terraform
+resource "gocd_artifact_store" "docker" {
+    store_id  = "docker"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_artifact_store.docker docker
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/auth_config.md

@@ -21,6 +21,17 @@ resource "gocd_auth_config" "password_file_config" {
 }
 ```
 
+## Importing the existing GoCD authorization configuration to Terraform State
+```terraform
+resource "gocd_auth_config" "password_file_config" {
+    profile_id = "admin_new"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_auth_config.password_file_config admin_new
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/cluster_profile.md

@@ -25,6 +25,17 @@ resource "gocd_cluster_profile" "kube_cluster_profile" {
 }
 ```
 
+## Importing the existing elastic agent profile to Terraform State
+```terraform
+resource "gocd_cluster_profile" "sample_cluster_profile" {
+    profile_id         = "sample_ec2"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_cluster_profile.sample_cluster_profile sample_ec2
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/elastic_agent_profile.md

@@ -21,6 +21,17 @@ resource "gocd_elastic_agent_profile" "sample_kubernetes" {
 }
 ```
 
+## Importing the existing cluster profile to Terraform State
+```terraform
+resource "gocd_elastic_agent_profile" "some_cluster_profile" {
+    profile_id = "kube_cluster_profile"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_elastic_agent_profile.some_cluster_profile kube_cluster_profile
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/environment.md

@@ -24,6 +24,17 @@ resource "gocd_environment" "sample_environment" {
 }
 ```
 
+## Importing the existing GoCD environments to Terraform State
+```terraform
+resource "gocd_environment" "sample_environment" {
+    name = "sample_environment"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_environment.sample_environment sample_environment
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

templates/resources/artifact_store.md.tmpl

@@ -25,6 +25,17 @@ resource "gocd_artifact_store" "docker" {
 }
 ```
 
+## Importing the existing GoCD artifact store to Terraform State
+```terraform
+resource "gocd_artifact_store" "docker" {
+    store_id  = "docker"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_artifact_store.docker docker
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

templates/resources/auth_config.md.tmpl

@@ -21,6 +21,17 @@ resource "gocd_auth_config" "password_file_config" {
 }
 ```
 
+## Importing the existing GoCD authorization configuration to Terraform State
+```terraform
+resource "gocd_auth_config" "password_file_config" {
+    profile_id = "admin_new"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_auth_config.password_file_config admin_new
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

templates/resources/cluster_profile.md.tmpl

@@ -25,6 +25,17 @@ resource "gocd_cluster_profile" "kube_cluster_profile" {
 }
 ```
 
+## Importing the existing elastic agent profile to Terraform State
+```terraform
+resource "gocd_cluster_profile" "sample_cluster_profile" {
+    profile_id         = "sample_ec2"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_cluster_profile.sample_cluster_profile sample_ec2
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

templates/resources/elastic_agent_profile.md.tmpl

@@ -21,6 +21,17 @@ resource "gocd_elastic_agent_profile" "sample_kubernetes" {
 }
 ```
 
+## Importing the existing cluster profile to Terraform State
+```terraform
+resource "gocd_elastic_agent_profile" "some_cluster_profile" {
+    profile_id = "kube_cluster_profile"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_elastic_agent_profile.some_cluster_profile kube_cluster_profile
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

templates/resources/environment.md.tmpl

@@ -24,6 +24,17 @@ resource "gocd_environment" "sample_environment" {
 }
 ```
 
+## Importing the existing GoCD environments to Terraform State
+```terraform
+resource "gocd_environment" "sample_environment" {
+    name = "sample_environment"
+}
+```
+
+```shell
+# Once the above code is added, the resource can be imported by running the below command.
+terraform import gocd_environment.sample_environment sample_environment
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema