Respond to Tener feedback

- Edit the "Terraform Provider" guide title to describe the purpose of
  the guide more explicitly, distinguishing it from the new guide.
- Describe general rules for finding the ID of a resource, rather than
  using a comprehensive table.
- Incorporate the import instructions into the setup guide. This way, we
  don't need to clarify the relationship between two guides, which
  wasn't entirely clear at the outset.
- Add a more explicit benefit statement for importing resources.
- Use the `-v` flag in `rm` commands

docs/config.json

@@ -659,13 +659,9 @@
               "slug": "/management/dynamic-resources/teleport-operator-standalone/"
             },
             {
-              "title": "Terraform Provider",
+              "title": "Set up the Terraform Provider",
               "slug": "/management/dynamic-resources/terraform-provider/"
-            },
-	    {
-	      "title": "Import Teleport Resources into Terraform",
-	      "slug": "/management/dynamic-resources/import-terraform-resources/"
-	    }
+            }
           ]
         },
         {

docs/pages/management/dynamic-resources.mdx

@@ -120,9 +120,6 @@ resource "teleport_role" "developer" {
 [Get started with the Terraform
 provider](./dynamic-resources/terraform-provider.mdx).
 
-[Import Teleport resources](./dynamic-resources/import-terraform-resources.mdx)
-that you have already created as Terraform resources.
-
 ### Teleport Kubernetes Operator
 
 The Teleport Kubernetes Operator lets you apply Teleport resources as Kubernetes

docs/pages/management/dynamic-resources/terraform-provider.mdx

@@ -1,5 +1,5 @@
 ---
-title: Terraform Provider
+title: Set up the Teleport Terraform Provider
 description: How to manage dynamic resources using the Teleport Terraform provider.
 videoBanner: YgNHD4SS8dg
 ---
@@ -29,9 +29,12 @@ and Machine ID](../../machine-id/deployment/spacelift.mdx).
   # Terraform v(=terraform.version=)
   ```
 
+  To import existing Teleport resources as Terraform resources, you must have
+  Terraform version `v1.5.0` or above.
+
 - (!docs/pages/includes/tctl.mdx!)
 
-## Step 1/3. Create Teleport credentials for Terraform
+## Step 1/4. Create Teleport credentials for Terraform
 
 Terraform needs a signed identity file from the Teleport cluster certificate
 authority to manage resources in the cluster. To prepare credentials using a local Teleport bot:
@@ -130,8 +133,8 @@ paste in the following content:
    #! /usr/bin/env bash
 
    tctl bots rm terraform-test
-   rm -rf ./terraform-identity
-   rm -rf ./tbot-data
+   rm -rfv ./terraform-identity
+   rm -rfv ./tbot-data
    ```
 
    This script will be used later to clean up our bot in between runs and when we're done.
@@ -144,7 +147,7 @@ paste in the following content:
    $ ./create_and_run_terraform_bot.sh
    ```
 
-## Step 2/3. Prepare a Terraform configuration file
+## Step 2/4. Prepare a Terraform configuration file
 
 To prepare a Terraform configuration file:
 
@@ -166,7 +169,7 @@ To prepare a Terraform configuration file:
    </TabItem>
    </Tabs>
 
-## Step 3/3. Validate the configuration
+## Step 3/4. Validate the configuration
 
 To apply the configuration:
 
@@ -200,11 +203,85 @@ To apply the configuration:
 
    If you need to start the bot back up, you can run the two bot scripts as many times as necessary.
 
+## Step 4/4. [Optional] Import existing resources
+
+This section shows you how to import existing dynamic Teleport resources as
+Terraform resources. 
+
+If you already created Teleport resources using another client tool like `tctl`
+or the Kubernetes Operator, and want to manage all Teleport resources using your
+Terraform configuration, follow these steps to generate a `.tf` file that
+contains `resource` blocks that represent your existing Teleport resources.
+
+By defining all Teleport resources in one place, you can help ensure that your
+cluster configuration matches your expectations.
+
+### Add an `import` block
+
+1. On your workstation, navigate to your root Teleport Terraform module.
+
+1. Open a file in your text editor to configure Terraform imports. To keep your
+   configuration tidy, open a new file called `imports.tf`.
+
+1. Add an `import` block to `imports.tf`. Use the `to` field to indicate the
+   name of the resource you want to generate configuration for in Terraform. The
+   following example imports a Teleport role called `myrole`:
+
+   ```hcl
+   import {
+     to = teleport_role.myrole
+   }
+   ```
+
+### Retrieve the ID of your resource
+
+1. Retrieve the ID of the resource. The method to use depends on the resource
+   type. Use the following rules to do so:
+
+   If the resource is `teleport_provision_token`, the ID is the `metadata.id` of
+   the resource.
+
+   If the resource can only have one instance, use the name of the resource type
+   without the `teleport` prefix. For example:
+
+   | Resource                              | ID                           |
+   |---------------------------------------|------------------------------|
+   | `teleport_cluster_maintenance_config` | `cluster_maintenance_config` |
+   | `teleport_cluster_networking_config`  | `cluster_networking_config`  |
+
+   For all othe resources, the ID is always the `metadata.name` of the resource.
+
+   For example, the `teleport_role` resource uses the role's `metadata.name`
+   field for its ID. To find all possible role IDs, run the following command:
+
+   ```code
+   $ tctl get roles --format json | jq '.[].metadata.name'
+   ```
+
+1. In the `import` block, assign the `id` field to the resource ID you retrieved
+   earlier. For example, to import a Teleport role with a `metadata.name` of
+   `myrole`, add the following:
+
+   ```diff
+     import {
+       to = teleport_role.myrole
+   +   id = "myrole"
+     }
+   ```
+
+### Generate a configuration file
+
+1. Generate a resource configuration
+
+   ```code
+   $ terraform plan -generate-config-out=imported-resources.tf
+   ```
+
+1. Inspect the resulting file, `imported-resources.tf`. If the new `resource`
+   block looks correct, you can check the file into source control.
+
 ## Next steps
 
-- If you have already created Teleport resources with another tool, such as
-  `tctl`, learn how to [import Teleport resources into
-  Terraform](./import-terraform-resources.mdx).
 - Follow [the user and role IaC guide](./user-and-role.mdx) to use the Terraform
   Provider to create Teleport users and grant them roles.
 - Explore the full list of supported [Terraform provider