[Doc] Unify/reorganize notes in docs for resources/data sources (#4657)

## Changes
<!-- Summary of your changes that are easy to understand -->

Changes include:

* Remove not necessary `**Note**` in `->`, etc.
* Put notes about account or workspace level provider after the first
paragraph, so it's easier to understand what resource/data source is
doing, and then read the note.
* Added missing notes about account or workspace level provider
* Removed repeated notes about `authentication is not configured for
provider errors` that is more about troubleshooting than about specific
resource/data source.

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

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

---------

Co-authored-by: vuong-nguyen <[email protected]>

Author: alexott

NEXT_CHANGELOG.md

@@ -10,6 +10,8 @@
 
 ### Documentation
 
+ * Unify/reorganize notes in docs for resources/data sources ([#4657](https://github.com/databricks/terraform-provider-databricks/pull/4657))
+
 ### Exporter
 
 ### Internal Changes

docs/data-sources/app.md

@@ -3,6 +3,8 @@ subcategory: "Apps"
 ---
 # databricks_app Data Source
 
+-> This data source can only be used with a workspace-level provider!
+
 -> This feature is in [Public Preview](https://docs.databricks.com/release-notes/release-types.html).
 
 [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.

docs/data-sources/apps.md

@@ -3,6 +3,8 @@ subcategory: "Apps"
 ---
 # databricks_apps Data Source
 
+-> This data source can only be used with a workspace-level provider!
+
 -> This feature is in [Public Preview](https://docs.databricks.com/release-notes/release-types.html).
 
 [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.

docs/data-sources/aws_assume_role_policy.md

@@ -6,6 +6,8 @@ subcategory: "Deployment"
 
 This data source constructs necessary AWS STS assume role policy for you.
 
+-> This data source can be used with an account or workspace-level provider.
+
 ## Example Usage
 
 End-to-end example of provisioning Cross-account IAM role with [databricks_mws_credentials](../resources/mws_credentials.md) and [aws_iam_role](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role):

docs/data-sources/aws_bucket_policy.md

@@ -5,6 +5,8 @@ subcategory: "Deployment"
 
 This datasource configures a simple access policy for AWS S3 buckets, so that Databricks can access data in it.
 
+-> This data source can be used with an account or workspace-level provider.
+
 ## Example Usage
 
 ```hcl

docs/data-sources/aws_crossaccount_policy.md

@@ -3,10 +3,10 @@ subcategory: "Deployment"
 ---
 # databricks_aws_crossaccount_policy Data Source
 
--> **Note** This data source can only be used with an account-level provider!
-
 This data source constructs necessary AWS cross-account policy for you, which is based on [official documentation](https://docs.databricks.com/administration-guide/account-api/iam-role.html#language-Your%C2%A0VPC,%C2%A0default).
 
+-> This data source can be used with an account or workspace-level provider.
+
 ## Example Usage
 
 For more detailed usage please see [databricks_aws_assume_role_policy](aws_assume_role_policy.md) or [databricks_aws_s3_mount](../resources/mount.md) pages.

docs/data-sources/aws_unity_catalog_assume_role_policy.md

@@ -3,10 +3,12 @@ subcategory: "Deployment"
 ---
 # databricks_aws_unity_catalog_assume_role_policy Data Source
 
--> **Note** This resource has an evolving API, which may change in future versions of the provider. Please always consult [latest documentation](https://docs.databricks.com/data-governance/unity-catalog/get-started.html#configure-a-storage-bucket-and-iam-role-in-aws) in case of any questions.
-
 This data source constructs the necessary AWS Unity Catalog assume role policy for you.
 
+-> This data source can be used with an account or workspace-level provider.
+
+-> This data source has an evolving API, which may change in future versions of the provider. Please always consult [latest documentation](https://docs.databricks.com/data-governance/unity-catalog/get-started.html#configure-a-storage-bucket-and-iam-role-in-aws) in case of any questions.
+
 ## Example Usage
 
 ```hcl

docs/data-sources/aws_unity_catalog_policy.md

@@ -3,10 +3,12 @@ subcategory: "Deployment"
 ---
 # databricks_aws_unity_catalog_policy Data Source
 
--> **Note** This resource has an evolving API, which may change in future versions of the provider. Please always consult [latest documentation](https://docs.databricks.com/data-governance/unity-catalog/get-started.html#configure-a-storage-bucket-and-iam-role-in-aws) in case of any questions.
-
 This data source constructs the necessary AWS Unity Catalog policy for you.
 
+-> This data source can be used with an account or workspace-level provider.
+
+-> This data source has an evolving API, which may change in future versions of the provider. Please always consult [latest documentation](https://docs.databricks.com/data-governance/unity-catalog/get-started.html#configure-a-storage-bucket-and-iam-role-in-aws) in case of any questions.
+
 ## Example Usage
 
 ```hcl

docs/data-sources/budget_policies.md

@@ -2,10 +2,10 @@
 subcategory: "FinOps"
 ---
 # databricks_budget_policies Data Source
-This data source can be used to fetch the list of budget policies. 
 
--> **Note** This data source can only be used with an account-level provider!
+This data source can be used to fetch the list of budget policies. 
 
+-> This data source can only be used with an account-level provider!
 
 ## Example Usage
 
@@ -26,4 +26,4 @@ data "databricks_budget_policies" "all" {
 
 Data source exposes the following attributes:
 
-- `budget_policies` - The list of budget policy.
+- `budget_policies` - The list of budget policy.

docs/data-sources/budget_policy.md

@@ -2,9 +2,10 @@
 subcategory: "FinOps"
 ---
 # databricks_budget_policy Data Source
+
 This data source can be used to get a single budget policy. 
 
--> **Note** This data source can only be used with an account-level provider!
+-> This data source can only be used with an account-level provider!
 
 ## Example Usage
 
@@ -27,4 +28,4 @@ Data source allows you to get a budget policy by the following attribute
 Data source exposes the following attributes:
 
 - `policy_id` - The id of the budget policy.
-- `policy_name` - The name of the budget policy.
+- `policy_name` - The name of the budget policy.

docs/data-sources/catalog.md

@@ -3,12 +3,10 @@ subcategory: "Unity Catalog"
 ---
 # databricks_catalog Data Source
 
--> **Note** This data source can only be used with a workspace-level provider!
-
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves details of a specific catalog in Unity Catalog, that were created by Terraform or manually. Use [databricks_catalogs](catalogs.md) to retrieve IDs of multiple catalogs from Unity Catalog
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Read  on a specific catalog `test`:

docs/data-sources/catalogs.md

@@ -3,12 +3,10 @@ subcategory: "Unity Catalog"
 ---
 # databricks_catalogs Data Source
 
--> **Note** This data source can only be used with a workspace-level provider!
-
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves a list of [databricks_catalog](../resources/catalog.md) ids, that were created by Terraform or manually, so that special handling could be applied.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Listing all catalogs:

docs/data-sources/cluster.md

@@ -3,10 +3,10 @@ subcategory: "Compute"
 ---
 # databricks_cluster Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves information about a [databricks_cluster](../resources/cluster.md) using its id. This could be retrieved programmatically using [databricks_clusters](../data-sources/clusters.md) data source.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Retrieve attributes of each SQL warehouses in a workspace

docs/data-sources/cluster_policy.md

@@ -4,10 +4,10 @@ subcategory: "Compute"
 
 # databricks_cluster_policy Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves information about [databricks_cluster_policy](../resources/cluster_policy.md).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Referring to a cluster policy by name:

docs/data-sources/clusters.md

@@ -3,10 +3,10 @@ subcategory: "Compute"
 ---
 # databricks_clusters Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves a list of [databricks_cluster](../resources/cluster.md#cluster_id) ids, that were created by Terraform or manually, with or without [databricks_cluster_policy](../resources/cluster_policy.md).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Retrieve cluster IDs for all clusters:

docs/data-sources/current_config.md

@@ -5,6 +5,8 @@ subcategory: "Deployment"
 
 Retrieves information about the currently configured provider to make a decision, for example, add a dynamic block based on the specific cloud.
 
+-> This data source can be used with an account or workspace-level provider.
+
 ## Example Usage
 
 Create cloud-specific [databricks_storage_credential](../resources/storage_credential.md):

docs/data-sources/current_metastore.md

@@ -5,9 +5,7 @@ subcategory: "Unity Catalog"
 
 Retrieves information about metastore attached to a given workspace.
 
--> **Note** This is the workspace-level data source.
-
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) to prevent _authentication is not configured for provider_ errors.
+-> This data source can only be used with a workspace-level provider!
 
 ## Example Usage
 

docs/data-sources/current_user.md

@@ -3,10 +3,10 @@ subcategory: "Security"
 ---
 # databricks_current_user Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves information about [databricks_user](../resources/user.md) or [databricks_service_principal](../resources/service_principal.md), that is calling Databricks REST API. Might be useful in applying the same Terraform by different users in the shared workspace for testing purposes.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Create personalized [databricks_job](../resources/job.md) and [databricks_notebook](../resources/notebook.md):

docs/data-sources/dashboards.md

@@ -5,6 +5,8 @@ subcategory: "Workspace"
 
 This data source allows you to retrieve information about Databricks [Dashboards](https://docs.databricks.com/en/dashboards/index.html).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 ```hcl

docs/data-sources/dbfs_file.md

@@ -3,10 +3,10 @@ subcategory: "Storage"
 ---
 # databricks_dbfs_file Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 This data source allows to get file content from [Databricks File System (DBFS)](https://docs.databricks.com/data/databricks-file-system.html).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 ```hcl

docs/data-sources/dbfs_file_paths.md

@@ -3,10 +3,10 @@ subcategory: "Storage"
 ---
 # databricks_dbfs_file_paths Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 This data source allows to get list of file names from get file content from [Databricks File System (DBFS)](https://docs.databricks.com/data/databricks-file-system.html).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 ```hcl

docs/data-sources/directory.md

@@ -3,10 +3,10 @@ subcategory: "Workspace"
 ---
 # databricks_directory Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 This data source allows to get information about a directory in a Databricks Workspace.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 ```hcl

docs/data-sources/external_location.md

@@ -3,10 +3,10 @@ subcategory: "Unity Catalog"
 ---
 # databricks_external_location Data Source
 
--> **Note** This data source can only be used with a workspace-level provider!
-
 Retrieves details about a [databricks_external_location](../resources/external_location.md) that were created by Terraform or manually.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Getting details of an existing external location in the metastore

docs/data-sources/external_locations.md

@@ -3,10 +3,10 @@ subcategory: "Unity Catalog"
 ---
 # databricks_external_locations Data Source
 
--> **Note** This data source can only be used with a workspace-level provider!
-
 Retrieves a list of [databricks_external_location](./external_location.md) objects, that were created by Terraform or manually, so that special handling could be applied.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 List all external locations in the metastore

docs/data-sources/functions.md

@@ -3,10 +3,10 @@ subcategory: "Unity Catalog"
 ---
 # databricks_functionss Data Source
 
--> This data source can only be used with a workspace-level provider!
-
 Retrieves a list of [User-Defined Functions (UDFs) registered in the Unity Catalog](https://docs.databricks.com/en/udf/unity-catalog.html).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 List all functions defined in a specific schema (`main.default` in this example):

docs/data-sources/group.md

@@ -3,10 +3,10 @@ subcategory: "Security"
 ---
 # databricks_group Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves information about [databricks_group](../resources/group.md) members, entitlements and instance profiles.
 
+-> This data source can be used with an account or workspace-level provider.
+
 ## Example Usage
 
 Adding user to administrative group

docs/data-sources/instance_pool.md

@@ -4,10 +4,10 @@ subcategory: "Compute"
 
 # databricks_instance_pool Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves information about [databricks_instance_pool](../resources/instance_pool.md).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Referring to an instance pool by name:

docs/data-sources/instance_profiles.md

@@ -6,6 +6,8 @@ subcategory: "Deployment"
 
 Lists all available [databricks_instance_profiles](../resources/instance_profile.md).
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Get all instance profiles:

docs/data-sources/job.md

@@ -3,10 +3,10 @@ subcategory: "Compute"
 ---
 # databricks_job Data Source
 
--> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../guides/troubleshooting.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _default auth: cannot configure default credentials_ errors.
-
 Retrieves the settings of [databricks_job](../resources/job.md) by name or by id. Complements the feature of the [databricks_jobs](jobs.md) data source.
 
+-> This data source can only be used with a workspace-level provider!
+
 ## Example Usage
 
 Getting the existing cluster id of specific [databricks_job](../resources/job.md) by name or by id: