Merge pull request hashicorp#359 from terraform-providers/paddy_95_dn…

…s_ns dns: Add special handling for ns records.
chrisst · Nov 8, 2017 · 88b1905 · 88b1905
2 parents f260129 + 8dd1876
commit 88b1905
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/r/dns_record_set.markdown b/docs/r/dns_record_set.markdown
@@ -10,6 +10,12 @@ description: |-
 
 Manages a set of DNS records within Google Cloud DNS.
 
+~> **Note:** The Google Cloud DNS API requires NS records be present at all
+times. To accommodate this, when creating NS records, the default records
+Google automatically creates will be silently overwritten.  Also, when
+destroying NS records, Terraform will not actually remove NS records, but will
+report that it did.
+
 ## Example Usage
 
 ### Binding a DNS name to the ephemeral IP of a new instance: