add details about identity arg in import ref

Author: trujillo-adam

content/terraform/v1.12.x/docs/language/block/import.mdx

@@ -14,8 +14,8 @@ An `import` block supports the following configuration:
 
 - [`import`](#import) &nbsp block
   - [`to`](#to) &nbsp address | required
-  - [`id`](#id) &nbsp string  
-<!--   - [`identity`](#identity) &nbsp map | mutually exclusive with `id` -->
+  - [`id`](#id) &nbsp string   
+  - [`identity`](#identity) &nbsp map | mutually exclusive with `id`
   - [`for_each`](#for_each) &nbsp map or set of strings
   - [`provider`](#provider) &nbsp reference
 
@@ -95,20 +95,18 @@ You must specify a string or an expression that evaluates to a string. The ID mu
 
 The value of the `id` argument depends on the type of resource you are importing. You can only import resources that are supported by the provider. For information on how to import a resource, refer to the provider documentation.
 
-<!--// HIDING INFO ABOUT IDENTITY FOR NOW // 
 You cannot use the `id` argument and [`identity` argument](#identity) in the same `import` block. 
--->
 
 #### Summary
 
 - Data type: String
 - Default: None
 - Example: [Import a single resource](#import-a-single-resource)
 
-<!-- leave out for now - providers are not using this yet
+
 ### `identity`
 
-The  `identity` argument specifies a resource identity object that uniquely identifies a resource. 
+The  `identity` argument specifies a set of attributes that uniquely identifies a resource. 
 
 ```hcl
 import {
@@ -118,9 +116,7 @@ import {
 }
 ```
 
-The `identity` argument is an object of key-value pairs that uniquely identify a resource. The keys and values are specific to the resource type and provider.
-
-The key-value pair for the `identity` object  depends on the type of resource you are importing. You can only import resources that are supported by the provider. Refer to the provider documentation for information about how to retrieve the `identity`.  
+The specific attributes are specific to the resource type and provider. You can only import resources that are supported by the provider. Refer to your provider documentation for details.  
 
 You cannot use the `identity` argument and [`id` argument](#id) in the same `import` block.
 
@@ -130,7 +126,6 @@ You cannot use the `identity` argument and [`id` argument](#id) in the same `imp
 - Default: None
 - Example: [Import a single resource](#import-a-single-resource)
 
--->
 
 ### `for_each`
 
@@ -204,8 +199,13 @@ The following examples show how to write configuration for common use cases.
 
 ### Import a single resource
 
-In the following example, Terraform imports `example-bucket` into a resource at `aws_s3_bucket.this`:
+You can import an individual resource by specifying its ID in `id` argument or by specifying the set of identifying attributes in the `identity` argument.  
+
+<Tabs>
+
+<Tab heading="Import using ID">
 
+In the following example, Terraform imports `example-bucket` into a resource at `aws_s3_bucket.this`:
 
 ```hcl
 import {
@@ -214,13 +214,34 @@ import {
 }
 
 resource "aws_s3_bucket" "this" {
-}
   # …
 }
 ```
 
 Refer to the [AWS provider documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/instance#import) in the Terraform registry for more information about importing AWS instances.
 
+</Tab>
+
+<Tab heading="Import using identity attributes">
+
+In the following example, Terraform imports an S3 bucket using its `account_id`, `bucket`, and `region` attributes:
+
+```hcl
+import {
+  to = aws_s3_bucket.bucket
+  identity = {
+    account_id = "622801496880"
+    bucket     = "hjarui4t89efuh"
+    region     = "us-east-1"
+  }
+}
+```
+
+
+</Tab>
+
+</Tabs>
+
 ### Import multiple resources
 
 In the following example, the `for_each` argument loops through the key-value pairs defined in the `buckets` map. For each pair, Terraform imports the S3 bucket into the `aws_s3_bucket.this` resource. The `[each.key]` index maps to the keys in `locals` block, such as `aws_s3_bucket.this["staging"]`. 

content/terraform/v1.13.x/docs/language/block/import.mdx

@@ -14,8 +14,8 @@ An `import` block supports the following configuration:
 
 - [`import`](#import) &nbsp block
   - [`to`](#to) &nbsp address | required
-  - [`id`](#id) &nbsp string  
-<!--   - [`identity`](#identity) &nbsp map | mutually exclusive with `id` -->
+  - [`id`](#id) &nbsp string   
+  - [`identity`](#identity) &nbsp map | mutually exclusive with `id`
   - [`for_each`](#for_each) &nbsp map or set of strings
   - [`provider`](#provider) &nbsp reference
 
@@ -95,20 +95,18 @@ You must specify a string or an expression that evaluates to a string. The ID mu
 
 The value of the `id` argument depends on the type of resource you are importing. You can only import resources that are supported by the provider. For information on how to import a resource, refer to the provider documentation.
 
-<!--// HIDING INFO ABOUT IDENTITY FOR NOW // 
 You cannot use the `id` argument and [`identity` argument](#identity) in the same `import` block. 
--->
 
 #### Summary
 
 - Data type: String
 - Default: None
 - Example: [Import a single resource](#import-a-single-resource)
 
-<!-- leave out for now - providers are not using this yet
+
 ### `identity`
 
-The  `identity` argument specifies a resource identity object that uniquely identifies a resource. 
+The  `identity` argument specifies a set of attributes that uniquely identifies a resource. 
 
 ```hcl
 import {
@@ -118,9 +116,7 @@ import {
 }
 ```
 
-The `identity` argument is an object of key-value pairs that uniquely identify a resource. The keys and values are specific to the resource type and provider.
-
-The key-value pair for the `identity` object  depends on the type of resource you are importing. You can only import resources that are supported by the provider. Refer to the provider documentation for information about how to retrieve the `identity`.  
+The specific attributes are specific to the resource type and provider. You can only import resources that are supported by the provider. Refer to your provider documentation for details.  
 
 You cannot use the `identity` argument and [`id` argument](#id) in the same `import` block.
 
@@ -130,7 +126,6 @@ You cannot use the `identity` argument and [`id` argument](#id) in the same `imp
 - Default: None
 - Example: [Import a single resource](#import-a-single-resource)
 
--->
 
 ### `for_each`
 
@@ -204,8 +199,13 @@ The following examples show how to write configuration for common use cases.
 
 ### Import a single resource
 
-In the following example, Terraform imports `example-bucket` into a resource at `aws_s3_bucket.this`:
+You can import an individual resource by specifying its ID in `id` argument or by specifying the set of identifying attributes in the `identity` argument.  
 
+<Tabs>
+
+<Tab heading="Import using ID">
+
+In the following example, Terraform imports `example-bucket` into a resource at `aws_s3_bucket.this`:
 
 ```hcl
 import {
@@ -214,13 +214,34 @@ import {
 }
 
 resource "aws_s3_bucket" "this" {
-}
   # …
 }
 ```
 
 Refer to the [AWS provider documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/instance#import) in the Terraform registry for more information about importing AWS instances.
 
+</Tab>
+
+<Tab heading="Import using identity attributes">
+
+In the following example, Terraform imports an S3 bucket using its `account_id`, `bucket`, and `region` attributes:
+
+```hcl
+import {
+  to = aws_s3_bucket.bucket
+  identity = {
+    account_id = "622801496880"
+    bucket     = "hjarui4t89efuh"
+    region     = "us-east-1"
+  }
+}
+```
+
+
+</Tab>
+
+</Tabs>
+
 ### Import multiple resources
 
 In the following example, the `for_each` argument loops through the key-value pairs defined in the `buckets` map. For each pair, Terraform imports the S3 bucket into the `aws_s3_bucket.this` resource. The `[each.key]` index maps to the keys in `locals` block, such as `aws_s3_bucket.this["staging"]`. 
@@ -302,4 +323,4 @@ import {
 
 resource "aws_instance" "web" {
   # ...
-}
+}