Fix some docs (#2365)

Author: bogdanrdc

docs/resources/volume.md

@@ -4,9 +4,9 @@ subcategory: "Unity Catalog"
 # databricks_volume (Resource)
 Volumes are a new Unity Catalog (UC) capability for accessing, storing, governing, and organizing files. Volumes unlock new processing capabilities for data governed by the Unity Catalog, including support for most machine learning and data science workloads. You can use volumes to store and access files in any format; data can be structured, semi-structured, or unstructured.
 
-With Volumes, files managed centrally in Unity Catalogare are organized under a 3-level namespace: `<catalog>.<schema>.<volume>`.
+Volumes are organized under a 3-level namespace: `<catalog>.<schema>.<volume>`.
 
-This resource does Creates, Read, Update, Delete and List Unity Catalog volumes.
+This resource manages Volumes in Unity Catalog.
 
 ## Example Usage
 
@@ -21,9 +21,9 @@ resource "databricks_catalog" "sandbox" {
 }
 
 resource "databricks_schema" "things" {
-  catalog_name = databricks_catalog.sandbox.id
+  catalog_name = databricks_catalog.sandbox.name
   name         = "things"
-  comment      = "this database is managed by terraform"
+  comment      = "this schema is managed by terraform"
   properties = {
     kind = "various"
   }
@@ -39,14 +39,13 @@ resource "databricks_storage_credential" "external" {
 resource "databricks_external_location" "some" {
   name            = "external-location"
   url             = "s3://${aws_s3_bucket.external.id}/some"
-  credential_name = databricks_storage_credential.external.id
+  credential_name = databricks_storage_credential.external.name
 }
 
 resource "databricks_volume" "this" {
   name = "quickstart_volume"
   catalog_name = databricks_catalog.sandbox.name
-  schema_name = databricks_schema.things.name 
-  owner = "volume_owner"
+  schema_name = databricks_schema.things.name
   volume_type = "EXTERNAL"
   storage_location   = databricks_external_location.some.url 
   comment = "this volume is managed by terraform"
@@ -57,17 +56,17 @@ resource "databricks_volume" "this" {
 
 The following arguments are supported:
 
-* `name` - Name of volume
-* `catalog_name` - Name of parent catalog
+* `name` - Name of the Volume
+* `catalog_name` - Name of parent Catalog
 * `schema_name` - Name of parent Schema relative to parent Catalog
-* `volume_type` - URL of storage location. Currently only `EXTERNAL` is supported
-* `owner` - (Optional) Name of the volume owner
-* `storage_location` - (Optional) If `EXTERNAL` volume type is used, then location of that volume
-* `comment` - (Optional) User-supplied free-form text.
+* `volume_type` - Volume type. `EXTERNAL` or `MANAGED`.
+* `owner` - (Optional) Name of the volume owner. 
+* `storage_location` - (Optional) Path inside an External Location. Only used for `EXTERNAL` Volumes.
+* `comment` - (Optional) Free-form text.
 
 ## Import
 
-This resource can be imported by `full_name` which is comprised under a 3-level namespace `<catalog>.<schema>.<volume>`
+This resource can be imported by `full_name` which is the 3-level Volume identifier: `<catalog>.<schema>.<volume>`
 
 ```bash
 $ terraform import databricks_volume.this <catalog_name>.<schema_name>.<name>