update readme

README.md

@@ -1,10 +1,14 @@
-## Terraform Provider
+## azureparse Terraform Provider
 
-Terraform provider to list resources in an Azure resource group.
+The azureparse provider can be used to list resources in an Azure resource group.
+
+Some Azure services create additional resources which Terraform shouldn't manage, but can and should update. The azureparse provider creates a no-op shim resource to handle dependency tree operations, which outputs information about resources within that resource group.
+
+A specific use case could be creating a network security rule on a network security group created by another Azure service (e.g. AKS).
 
 ## Example
 
-```terraform
+```hcl
 resource "azureparse_resource_group" "example" {
   resource_group_name = "some-resource-group-name"
 }

docs/index.md

@@ -7,9 +7,11 @@ description: |-
 
 # azureparse Provider
 
-The azureparse provider can be used to list resources in a resource group.
+The azureparse provider can be used to list resources in an Azure resource group.
 
-One use case: creating a network security rule on a network security group created by another Azure service (e.g. AKS).
+Some Azure services create additional resources which Terraform shouldn't manage, but can and should update. The azureparse provider creates a no-op shim resource to handle dependency tree operations, which outputs information about resources within that resource group.
+
+A specific use case could be creating a network security rule on a network security group created by another Azure service (e.g. AKS).
 
 ## Example Usage
 
@@ -46,4 +48,4 @@ resource "azurerm_route" "udr" {
 
 * `subscription_id` - (Optional)
 
-* `tenant_id` - (Optional)
+* `tenant_id` - (Optional)