diff --git a/website/docs/r/automation_module.html.markdown b/website/docs/r/automation_module.html.markdown
index 59f9b35a0d7df..36642c0b082b7 100644
--- a/website/docs/r/automation_module.html.markdown
+++ b/website/docs/r/automation_module.html.markdown
@@ -46,7 +46,7 @@ The following arguments are supported:
 
 * `automation_account_name` - (Required) The name of the automation account in which the Module is created. Changing this forces a new resource to be created.
 
-* `module_link` - (Required) The published Module link `module_link` block defined as blow.
+* `module_link` - (Required) A `module_link` block as defined blow.
 
 ---
 
@@ -54,7 +54,7 @@ The `module_link` block supports the following:
 
 * `uri` - (Required) The URI of the module content (zip or nupkg).
 
-* `hash` - (Optional) A `hash` block defined as below.
+* `hash` - (Optional) A `hash` block as defined below.
 
 ---
 
diff --git a/website/docs/r/automation_runbook.html.markdown b/website/docs/r/automation_runbook.html.markdown
index 6191a51003bd3..fbcb401225f78 100644
--- a/website/docs/r/automation_runbook.html.markdown
+++ b/website/docs/r/automation_runbook.html.markdown
@@ -136,7 +136,7 @@ The `draft` block supports:
 
 * `output_types` - (Optional) Specifies the output types of the runbook.
 
-* `parameters` - (Optional) A list of `parameters` block as define below.
+* `parameters` - (Optional) A list of `parameters` block as defined below.
 
 ---
 
diff --git a/website/docs/r/automation_software_update_configuration.html.markdown b/website/docs/r/automation_software_update_configuration.html.markdown
index 47bfd253540c4..9974fc19ba122 100644
--- a/website/docs/r/automation_software_update_configuration.html.markdown
+++ b/website/docs/r/automation_software_update_configuration.html.markdown
@@ -119,7 +119,7 @@ A `azure_query` block supports the following:
 
 * `tag_filter` - (Optional) Specifies how the specified tags to filter VMs. Possible values are `Any` and `All`.
 
-* `tags` - (Optional) A mapping of tags used for query filter defined as below.
+* `tags` - (Optional) A mapping of tags used for query filter as defined below.
 
 ---
 
diff --git a/website/docs/r/express_route_port.html.markdown b/website/docs/r/express_route_port.html.markdown
index c600cfddf4a74..f9b1948dcae42 100644
--- a/website/docs/r/express_route_port.html.markdown
+++ b/website/docs/r/express_route_port.html.markdown
@@ -84,9 +84,9 @@ In addition to the Arguments listed above - the following Attributes are exporte
 
 * `identity` - A `identity` block as defined below.
   
-* `link1` - A list of `link` block as defined below.
+* `link1` - A list of `link` blocks as defined below.
 
-* `link2` - A list of `link` block as defined below.
+* `link2` - A list of `link` blocks as defined below.
 
 * `guid` - The resource GUID of the Express Route Port.
   
diff --git a/website/docs/r/orbital_spacecraft.html.markdown b/website/docs/r/orbital_spacecraft.html.markdown
index d0179d6d30cf2..fc5471a68d578 100644
--- a/website/docs/r/orbital_spacecraft.html.markdown
+++ b/website/docs/r/orbital_spacecraft.html.markdown
@@ -55,9 +55,9 @@ The following arguments are supported:
 
 * `links` - (Required) A `links` block as defined below.
 
-* `two_line_elements` - (Required) A list of the two line elements(TLE), the first string in the list is the first line of TLE, the second one is the second line of TLE.
+* `two_line_elements` - (Required) A list of the two line elements (TLE), the first string being the first of the TLE, the second string being the second line of the TLE.
 
-* `title_line` - (Required) Title of the two line elements(TLE).
+* `title_line` - (Required) Title of the two line elements (TLE).
 
 * `tags` - (Optional) A mapping of tags to assign to the resource.
 
diff --git a/website/docs/r/virtual_network_gateway.html.markdown b/website/docs/r/virtual_network_gateway.html.markdown
index 4d78ffd68ad03..0ffdc60030f60 100644
--- a/website/docs/r/virtual_network_gateway.html.markdown
+++ b/website/docs/r/virtual_network_gateway.html.markdown
@@ -149,7 +149,7 @@ The following arguments are supported:
 
 * `bgp_settings` - (Optional) A `bgp_settings` block which is documented below. In this block the BGP specific settings can be defined.
 
-* `custom_route` - (Optional) A `custom_route` block as defined below. Specify a custom routes address space specified by the customer for virtual network gateway and VpnClient.
+* `custom_route` - (Optional) A `custom_route` block as defined below. Specifies a custom routes address space for a virtual network gateway and a VpnClient.
 
 * `generation` - (Optional) The Generation of the Virtual Network gateway. Possible values include `Generation1`, `Generation2` or `None`. Changing this forces a new resource to be created.
 
@@ -256,9 +256,9 @@ The `root_certificate` block supports:
 
 The `revoked_certificate` block supports:
 
-* `name` - (Required) Specify the name of the certificate resource.
+* `name` - (Required) Specifies the name of the certificate resource.
 
-* `public_cert_data` - (Required) Specify the public data of the certificate.
+* `public_cert_data` - (Required) Specifies the public data of the certificate.
 
 ---