Initial commit of adding org owner team membership doc notes (#1467)

Author: kfcampbell

website/docs/r/team_members.html.markdown

@@ -15,9 +15,11 @@ When applied, if the user hasn't accepted their invitation to the organization,
 
 When destroyed, all users will be removed from the team.
 
-~> **Note**: This resource is not compatible with `github_team_membership`. Use either `github_team_members` or `github_team_membership`.
+~> **Note** This resource is not compatible with `github_team_membership`. Use either `github_team_members` or `github_team_membership`.
 
-~> **Note**: You can accidentally lock yourself out of your team using this resource. Deleting a `github_team_members` resource removes access from anyone without organization-level access to the team. Proceed with caution. It should generally only be used with teams fully managed by Terraform.
+~> **Note** You can accidentally lock yourself out of your team using this resource. Deleting a `github_team_members` resource removes access from anyone without organization-level access to the team. Proceed with caution. It should generally only be used with teams fully managed by Terraform.
+
+~> **Note** Attempting to set a user who is an organization owner to "member" will result in the user being granted "maintainer" instead; this can result in a perpetual `terraform plan` diff that changes their status back to "member".
 
 ## Example Usage
 

website/docs/r/team_membership.html.markdown

@@ -14,7 +14,9 @@ the user will be added to the team. If the user hasn't accepted their invitation
 organization, they won't be part of the team until they do. When
 destroyed, the user will be removed from the team.
 
-~> **Note**: This resource is not compatible with `github_team_members`. Use either `github_team_members` or `github_team_membership`.
+~> **Note** This resource is not compatible with `github_team_members`. Use either `github_team_members` or `github_team_membership`.
+
+~> **Note** Organization owners may not be set as "members" of a team; they may only be set as "maintainers". Attempting to set organization an owner to "member" of a may result in a `terraform plan` diff that changes their status back to "maintainer".
 
 ## Example Usage