Docs covering the inline NSG/NSR resources. Fixes #115

website/docs/r/network_security_group.html.markdown

@@ -10,6 +10,10 @@ description: |-
 
 Create a network security group that contains a list of network security rules.
 
+~> **NOTE on Network Security Groups and Network Security Rules:** Terraform currently
+provides both a standalone [Network Security Rule resource](network_security_rule.html), and allows for Network Security Rules to be defined in-line within the [Network Security Group resource](network_security_group.html).
+At this time you cannot use a Network Security Group with in-line Network Security Rules in conjunction with any Network Security Rule resources. Doing so will cause a conflict of rule settings and will overwrite rules.
+
 ## Example Usage
 
 ```hcl

website/docs/r/network_security_rule.html.markdown

@@ -10,6 +10,10 @@ description: |-
 
 Create a Network Security Rule.
 
+~> **NOTE on Network Security Groups and Network Security Rules:** Terraform currently
+provides both a standalone [Network Security Rule resource](network_security_rule.html), and allows for Network Security Rules to be defined in-line within the [Network Security Group resource](network_security_group.html).
+At this time you cannot use a Network Security Group with in-line Network Security Rules in conjunction with any Network Security Rule resources. Doing so will cause a conflict of rule settings and will overwrite rules.
+
 ## Example Usage
 
 ```hcl
@@ -81,4 +85,4 @@ Network Security Rules can be imported using the `resource id`, e.g.
 
 ```
 terraform import azurerm_network_security_rule.rule1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/networkSecurityGroups/mySecurityGroup/securityRules/rule1
-```
+```