resource_group: documentation

website/docs/r/group.markdown

@@ -15,17 +15,35 @@ Manages a Group within Azure Active Directory.
 
 ## Example Usage
 
+*Basic example*
+
 ```hcl
 resource "azuread_group" "my_group" {
   name = "MyGroup"
 }
 ```
 
+*A group with members*
+
+```hcl
+resource "azuread_user" "my_user" {
+  display_name          = "John Doe"
+  password              = "notSecure123"
+  user_principal_name   = "[email protected]"
+}
+
+resource "azuread_group" "my_group" {
+  name = "MyGroup"
+  members = [ azuread_user.my_user.id /*, more users */ ]
+}
+```
+
 ## Argument Reference
 
 The following arguments are supported:
 
-* `name` - (Required) The display name for the Group.
+* `name` - (Required) The display name for the Group. Changing this forces a new resource to be created.
+* `members` (Optional) A set of users who should be members of this Group.
 
 -> **NOTE:** Group names are not unique within Azure Active Directory.
 
@@ -37,6 +55,8 @@ The following attributes are exported:
 
 * `name` - The Display Name of the Group.
 
+* `members` - The Group Members in the Group.
+
 ## Import
 
 Azure Active Directory Groups can be imported using the `object id`, e.g.