Release 0.3.0

Author: nfx

CONTRIBUTING.md

@@ -17,6 +17,14 @@ Contributing to Databricks Terraform Provider
 
 We happily welcome contributions to databricks-terraform. We use GitHub Issues to track community reported issues and GitHub Pull Requests for accepting changes.
 
+## Installing for Terraform 0.12
+
+If you use Terraform 0.12, please execute the following curl command in your shell:
+
+```bash
+curl https://raw.githubusercontent.com/databrickslabs/databricks-terraform/master/godownloader-databricks-provider.sh | bash -s -- -b $HOME/.terraform.d/plugins
+```
+
 ## Installing from source
 
 The following command (tested on Ubuntu 20.04) will install `make`, `golang`, `git` with all of the dependent packages as well as Databricks Terrafrom provider from sources. Required version of GoLang is at least 1.13. Required version of terraform is at least 0.12. 
@@ -29,19 +37,6 @@ cd terraform-provider-databricks
 make install
 ```
 
-Now your plugin for the Databricks Terraform provider is installed correctly. If you have Terraform 0.13, you'd need to paste configuration that might look like the following one into your `main.tf`:
-
-```hcl
-terraform {
-  required_providers {
-    databricks = {
-      source = "databrickslabs/databricks"
-      version = "0.2.3-22-gd91b475"
-    }
-  }
-}
-```
-
 Most likely, `terraform init -upgrade -verify-plugins=false -lock=false` would be a very great command to use.
 
 ## Developing provider

README.md

@@ -52,26 +52,20 @@
 
 [![build](https://github.com/databrickslabs/terraform-provider-databricks/workflows/build/badge.svg?branch=master)](https://github.com/databrickslabs/terraform-provider-databricks/actions?query=workflow%3Abuild+branch%3Amaster) [![codecov](https://codecov.io/gh/databrickslabs/terraform-provider-databricks/branch/master/graph/badge.svg)](https://codecov.io/gh/databrickslabs/terraform-provider-databricks)
 
-If you use Terraform 0.13, please refer to instructions specified at [registry page](https://registry.terraform.io/providers/databrickslabs/databricks/latest):
+If you use Terraform 0.13 or newer, please refer to instructions specified at [registry page](https://registry.terraform.io/providers/databrickslabs/databricks/latest). If you use older versions of Terraform or want to build it from sources, please refer to [contributing guidelines](CONTRIBUTING.md) page.
 
 ```hcl
 terraform {
   required_providers {
     databricks = {
       source = "databrickslabs/databricks"
-      version = "0.2.9"
+      version = "0.3.0"
     }
   }
 }
 ```
 
-If you use Terraform 0.12, please execute the following curl command in your shell:
-
-```bash
-curl https://raw.githubusercontent.com/databrickslabs/databricks-terraform/master/godownloader-databricks-provider.sh | bash -s -- -b $HOME/.terraform.d/plugins
-```
-
-Then create a small sample file, named `main.tf` with approximately following contents. Replace `<your PAT token>` with newly created [PAT Token](https://docs.databricks.com/dev-tools/api/latest/authentication.html). It will create [a simple cluster](https://databrickslabs.github.io/terraform-provider-databricks/resources/cluster/).
+Then create a small sample file, named `main.tf` with approximately following contents. Replace `<your PAT token>` with newly created [PAT Token](https://docs.databricks.com/dev-tools/api/latest/authentication.html). 
 
 ```terraform
 provider "databricks" {

docs/guides/azure-workspace.md

@@ -64,7 +64,7 @@ output "databricks_host" {
 
 ## Provider configuration
 
-In [the next step](workspace-management.md), please use the following configuration for the provider:
+In [the next step](workspace-management.md), please use the [special configurations for Azure](../index.md#special-configurations-for-azure):
 
 ```hcl
 provider "databricks" {

docs/index.md

@@ -166,7 +166,7 @@ Alternatively, you can provide this value as an environment variable `DATABRICKS
 
 ## Special configurations for Azure
 
-To work with Azure Databricks workspace, the provider must know its `id` (or construct it from `azure_subscription_id`, `azure_workspace_name` and `azure_workspace_name`). The provider works with [Azure CLI authentication](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli?view=azure-cli-latest) to facilitate local development workflows, though for automated scenarios a service principal auth is necessary (and specification of `azure_client_id`, `azure_client_secret` and `azure_tenant_id` parameters).
+To work with Azure Databricks workspace, the provider must know its `azure_workspace_resource_id` (or construct it from `azure_subscription_id`, `azure_resource_group` and `azure_workspace_name`). The provider works with [Azure CLI authentication](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli?view=azure-cli-latest) to facilitate local development workflows, though for automated scenarios a service principal auth is necessary (and specification of `azure_client_id`, `azure_client_secret` and `azure_tenant_id` parameters).
 
 ### Authenticating with Azure Service Principal