[docs] update repository_environment resource documentation (#3481)

* Update repository_environment.md with permissions note

Added note about verifying permissions for GitHub API.

* Update repository_environment.md.tmpl

Author: LarsFronius

docs/resources/repository_environment.md

@@ -8,6 +8,8 @@ description: |-
 
 This resource allows you to create and manage environments for a GitHub repository.
 
+~> Verify you have the correct permissions set up from the [GitHub API docs](https://docs.github.com/en/rest/deployments/environments?apiVersion=2022-11-28#create-or-update-an-environment)
+
 ## Example Usage
 
 ```terraform

templates/resources/repository_environment.md.tmpl

@@ -8,6 +8,8 @@ description: |-
 
 This resource allows you to create and manage environments for a GitHub repository.
 
+~> Verify you have the correct permissions set up from the [GitHub API docs](https://docs.github.com/en/rest/deployments/environments?apiVersion=2022-11-28#create-or-update-an-environment)
+
 ## Example Usage
 
 {{ tffile "examples/resources/repository_environment/example_1.tf" }}