diff --git a/Deploy-ServiceProvider.md b/Deploy-ServiceProvider.md
index 3c6fc6a..58c8c54 100644
--- a/Deploy-ServiceProvider.md
+++ b/Deploy-ServiceProvider.md
@@ -46,7 +46,7 @@ What's needed to setup the service provider components of zMontior.
     * Scale according to number of tenants, a starting scale on a single partition is 2000 RUs. 
 * Stream Analytics
   * Configure input : storage account main logs containers
-  * Configure output : CosmosDB collection
+  * Configure output : Cosmos DB collection
   * Define the query:
     ```SQL
     SELECT
diff --git a/Deploy-Tenant.md b/Deploy-Tenant.md
index 2a5fba4..48b3bb2 100644
--- a/Deploy-Tenant.md
+++ b/Deploy-Tenant.md
@@ -1,8 +1,8 @@
 # zMonitor
 
-## Tenant Deployment
+## Tenant \ Subscription Deployment
 
-Tenant operations monitoring is enabled through Operations Management Suite (OMS). What you monitor and report on is dependent on the solutions and agents deployed and how monitoring is configured per workload in each tenant.
+Tenant \ subscription operations monitoring is enabled through Operations Management Suite (OMS). What you monitor and report on is dependent on the solutions and agents deployed and how monitoring is configured per workload in each tenant.
 
 Monitoring is enabled using two core Azure components:
 
@@ -11,7 +11,7 @@ Monitoring is enabled using two core Azure components:
 
 The overall process for tenant monitoring is:
 
-1. Configure Log Analytics 
+1. Configure Log Analytics
 1. Define Log Analytics queries to extract the monitoring information required
 1. Schedule Azure Automation runbooks to execute queries and upload to service provider
 
@@ -39,7 +39,7 @@ The overall process for tenant monitoring is:
     azureadmin: <whatever>
     azureAdminPwd: <whatever>
     ```
-    NOTE: Ensure that the omsWorkspaceName is the same as the tenant name, for example, if registered tenant name is tenant1.onmicrosoft.com, then make the omsWorkspaceName "tenant1".
+    NOTE: Ensure that the omsWorkspaceName is the same as the tenant name, for example, if registered tenant name is tenant1.onmicrosoft.com, then make the omsWorkspaceName "tenant1". The omsWorkspace name is how you uniquely identify subscriptions or tenants.
 
     1. Wait for script execution to complete (takes about 10 minutes).
 
diff --git a/README.md b/README.md
index 10e858d..3ebbb6e 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 An Azure platform native monitoring solution that enables monitoring across multiple tenants or subscriptions.
 
-The primary goal is to utilize Azure native components, and deliver an as simple as possible, highly configurable and scalable, cost-effective monitoring solution. The driving force behind this solution was the need to be able to monitor Azure resources across tenants (for service providers), using Azure native tools. WHile there are many metrics and logs generated in Azure, surfacing this information across subscriptions/tenants proved challenging.
+The primary goal is to utilize Azure native components, and deliver an as simple as possible, highly configurable and scalable, cost-effective monitoring solution. The driving force behind this solution was the need to be able to monitor Azure resources across tenants (for service providers), using Azure native tools. While there are many metrics and logs generated in Azure, surfacing this information across subscriptions/tenants proved challenging.
 
 ## Solution