Tweak to documentation explaining caveats (#566)

Co-authored-by: Trent Rosenbaum <[email protected]>

Author: greg-oc

docs/resources/rediscloud_active_active_subscription_database.md

@@ -153,5 +153,12 @@ $ terraform import rediscloud_active_active_subscription_database.database-resou
 
 Note: Due to constraints in the Redis Cloud API, the import process will not import global attributes or override region attributes. If you wish to use these attributes in your Terraform configuration, you will need to manually add them to your Terraform configuration and run `terraform apply` to update the database.
 
-Additionally, the `memory_limit_in_gb` cannot be set during imports as it is deprecated. If you need to set the `memory_limit_in_gb` attribute, you will need to create a new database resource. It is recommended to use the `dataset_size_in_gb` attribute instead.
+Additionally, the `memory_limit_in_gb` cannot be set during imports as it is deprecated. If you need to set the `memory_limit_in_gb` attribute, you will need to create a new database resource. It is recommended to use the `dataset_size_in_gb` attribute instead since imports are supported.
 
+To update an existing configuration for a database which uses the `memory_limit_in_gb` field to use `dataset_size_in_gb`, you need to remove it from the state and import the resource again. e.g.
+
+```
+$ terraform state rm rediscloud_active_active_subscription_database.database-resource
+(Update the configuration to use `dataset_size_in_gb` instead of `memory_limit_in_gb`)
+$ terraform import rediscloud_active_active_subscription_database.database-resource 123456/12345678
+```

docs/resources/rediscloud_subscription_database.md

@@ -163,4 +163,12 @@ The `timeouts` block allows you to specify [timeouts](https://www.terraform.io/l
 $ terraform import rediscloud_subscription_database.database-resource 123456/12345678
 ```
 
-Note: Due to constraints in the Redis Cloud API, the `memory_limit_in_gb` cannot be set during imports as it is deprecated. If you need to set the `memory_limit_in_gb` attribute, you will need to create a new database resource. It is recommended to use the `dataset_size_in_gb` attribute instead.
+Note: Due to constraints in the Redis Cloud API, the `memory_limit_in_gb` cannot be set during imports as it is deprecated. If you need to set the `memory_limit_in_gb` attribute, you will need to create a new database resource. It is recommended to use the `dataset_size_in_gb` attribute instead since imports are supported.
+
+To update an existing configuration for a database which uses the `memory_limit_in_gb` field to use `dataset_size_in_gb`, you need to remove it from the state and import the resource again. e.g.
+
+```
+$ terraform state rm rediscloud_subscription_database.database-resource
+(Update the configuration to use `dataset_size_in_gb` instead of `memory_limit_in_gb`)
+$ terraform import rediscloud_subscription_database.database-resource 123456/12345678
+```