NSOF-5653 docs: add note to group attachment resource docs

Author: hod-alpert

docs/resources/group_roles_attachment.md

@@ -10,6 +10,10 @@ description: |-
 
 Attaches roles to group.
 
+~> **NOTE:** The **pfptmeta_group_roles_attachment** resource creates **exclusive** role attachments.
+Across the entire organization, all the roles attached to the group must be declared by a single pfptmeta_group_roles_attachment resource.
+This means that any group with the roles attached using any other method, including other Terraform resources, will have its role attachments revoked.
+
 ## Example Usage
 
 ```terraform

docs/resources/group_users_attachment.md

@@ -10,6 +10,8 @@ description: |-
 
 Adds users to group.
 
+~> **NOTE:** Multiple **pfptmeta_group_users_attachment** resources with the same group and users will result in inconsistent behavior!
+
 ## Example Usage
 
 ```terraform

templates/resources/group_roles_attachment.md.tmpl

@@ -10,6 +10,10 @@ description: |-
 
 {{ .Description | trimspace }}
 
+~> **NOTE:** The **pfptmeta_group_roles_attachment** resource creates **exclusive** role attachments.
+Across the entire organization, all the roles attached to the group must be declared by a single pfptmeta_group_roles_attachment resource.
+This means that any group with the roles attached using any other method, including other Terraform resources, will have its role attachments revoked.
+
 ## Example Usage
 
 {{tffile "examples/resources/pfptmeta_group_roles_attachment/resource.tf"}}

templates/resources/group_users_attachment.md.tmpl

@@ -10,6 +10,8 @@ description: |-
 
 {{ .Description | trimspace }}
 
+~> **NOTE:** Multiple **pfptmeta_group_users_attachment** resources with the same group and users will result in inconsistent behavior!
+
 ## Example Usage
 
 {{tffile "examples/resources/pfptmeta_group_users_attachment/resource.tf"}}