Fix databricks_mws_workspaces import documentation (#4699)

## Changes
The workspace import documentation references `databricks_mws_networks`
by mistake. This is probably a copy-paste error.

Additionally, I have made sure that all resources are documented using
the `import` block syntax first, followed by the `terraform import`
command.

## Tests
<!-- 
How is this tested? Please see the checklist below and also describe any
other relevant tests
-->

- [ ] `make test` run locally
- [ ] relevant change in `docs/` folder
- [ ] covered with integration tests in `internal/acceptance`
- [ ] using Go SDK
- [ ] using TF Plugin Framework

Author: mgyucht

NEXT_CHANGELOG.md

@@ -10,6 +10,8 @@
 
 ### Documentation
 
+* Fix import documentation for all resources ([#4699](https://github.com/databricks/terraform-provider-databricks/pull/4699/files)).
+
 ### Exporter
 
 ### Internal Changes

docs/resources/aibi_dashboard_embedding_access_policy_setting.md

@@ -29,6 +29,15 @@ The resource supports the following arguments:
 
 This resource can be imported by predefined name `global`:
 
+```hcl
+import {
+  to = databricks_aibi_dashboard_embedding_access_policy_setting.this
+  id = "global"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
 ```bash
 terraform import databricks_aibi_dashboard_embedding_access_policy_setting.this global
 ```

docs/resources/aibi_dashboard_embedding_approved_domains_setting.md

@@ -36,6 +36,15 @@ The resource supports the following arguments:
 
 This resource can be imported by predefined name `global`:
 
+```hcl
+import {
+  to = databricks_aibi_dashboard_embedding_approved_domains_setting.this
+  id = "global"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
 ```bash
 terraform import databricks_aibi_dashboard_embedding_approved_domains_setting.this global
 ```

docs/resources/alert.md

@@ -203,6 +203,15 @@ resource "databricks_permissions" "alert_usage" {
 
 This resource can be imported using alert ID:
 
+```hcl
+import {
+  to = databricks_alert.this
+  id = "<alert-id>"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
 ```bash
 terraform import databricks_alert.this <alert-id>
 ```

docs/resources/app.md

@@ -3,7 +3,7 @@ subcategory: "Apps"
 ---
 # databricks_app Resource
 
-[Databricks Apps](https://docs.databricks.com/en/dev-tools/databricks-apps/index.html) run directly on a customer’s Databricks instance, integrate with their data, use and extend Databricks services, and enable users to interact through single sign-on. This resource creates the application but does not handle app deployment, which should be handled separately as part of your CI/CD pipeline.
+[Databricks Apps](https://docs.databricks.com/en/dev-tools/databricks-apps/index.html) run directly on a customer's Databricks instance, integrate with their data, use and extend Databricks services, and enable users to interact through single sign-on. This resource creates the application but does not handle app deployment, which should be handled separately as part of your CI/CD pipeline.
 
 -> This feature is in [Public Preview](https://docs.databricks.com/release-notes/release-types.html).
 
@@ -105,7 +105,7 @@ import {
 }
 ```
 
-or using the `terraform` CLI:
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
 
 ```bash
 terraform import databricks_app.this <app_name>

docs/resources/artifact_allowlist.md

@@ -50,8 +50,17 @@ In addition to all arguments above, the following attributes are exported:
 
 This resource can be imported by name:
 
+```hcl
+import {
+  to = databricks_artifact_allowlist.this
+  id = "<metastore_id>|<artifact_type>"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
 ```bash
-terraform import databricks_artifact_allowlist.this '<metastore_id>|<artifact_type>'
+terraform import databricks_artifact_allowlist.this "<metastore_id>|<artifact_type>"
 ```
 
 ## Related Resources

docs/resources/budget.md

@@ -90,10 +90,19 @@ In addition to all arguments above, the following attributes are exported:
 
 ## Import
 
-This resource can be imported by Databricks account ID and Budget.
+This resource can be imported by Databricks account ID and Budget:
 
-```sh
-terraform import databricks_budget.this '<account_id>|<budget_configuration_id>'
+```hcl
+import {
+  to = databricks_budget.this
+  id = "<account_id>|<budget_configuration_id>"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
+```bash
+terraform import databricks_budget.this "<account_id>|<budget_configuration_id>"
 ```
 
 ## Related Resources

docs/resources/budget_policy.md

@@ -28,7 +28,7 @@ The following arguments are available:
 
 ### custom_tags Configuration Block
 
-* `key` - The key of the tag. - Must be unique among all custom tags of the same policy. Cannot be “budget-policy-name”, “budget-policy-id” or "budget-policy-resolution-result" as these tags are preserved. 
+* `key` - The key of the tag. - Must be unique among all custom tags of the same policy. Cannot be "budget-policy-name", "budget-policy-id" or "budget-policy-resolution-result" as these tags are preserved. 
 * `value` - The value of the tag. 
 
 ## Attribute Reference
@@ -45,6 +45,15 @@ In addition to all arguments above, the following attribute is exported:
 
 This resource can be imported by ID.
 
+```hcl
+import {
+  to = databricks_budget_policy.this
+  id = "policy_id"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
 ```sh
 terraform import databricks_budget_policy.this policy_id
 ```

docs/resources/catalog.md

@@ -49,6 +49,15 @@ In addition to all arguments above, the following attributes are exported:
 
 This resource can be imported by name:
 
+```hcl
+import {
+  to = databricks_catalog.this
+  id = "<name>"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
 ```bash
 terraform import databricks_catalog.this <name>
 ```

docs/resources/catalog_workspace_binding.md

@@ -40,6 +40,15 @@ The following arguments are required:
 
 This resource can be imported by using combination of workspace ID, securable type and name:
 
-```sh
+```hcl
+import {
+  to = databricks_catalog_workspace_binding.this
+  id = "<workspace_id>|<securable_type>|<securable_name>"
+}
+```
+
+Alternatively, when using `terraform` version 1.4 or earlier, import using the `terraform import` command:
+
+```bash
 terraform import databricks_catalog_workspace_binding.this "<workspace_id>|<securable_type>|<securable_name>"
 ```