diff --git a/website/docs/r/compute_global_address.html.markdown b/website/docs/r/compute_global_address.html.markdown
index 4ccc9f65..a3c758d1 100644
--- a/website/docs/r/compute_global_address.html.markdown
+++ b/website/docs/r/compute_global_address.html.markdown
@@ -66,17 +66,18 @@ The following arguments are supported:
 
 * `address` -
   (Optional)
-  The static external IP address represented by this resource.
+  The IP address or beginning of the address range represented by this
+  resource. This can be supplied as an input to reserve a specific
+  address or omitted to allow GCP to choose a valid one for you.
 
 * `description` -
   (Optional)
   An optional description of this resource.
-  Provide this property when you create the resource.
 
 * `ip_version` -
   (Optional)
   The IP Version that will be used by this address. Valid options are
-  IPV4 or IPV6. The default value is IPV4.
+  `IPV4` or `IPV6`. The default value is `IPV4`.
 
 * `address_type` -
   (Optional)