Adding docs to the resource

Signed-off-by: Diogenes Fernandes <diofeher@gmail.com>

Right aligning

Signed-off-by: Diogenes Fernandes <diofeher@gmail.com>

fmt issues

Signed-off-by: Diogenes Fernandes <diofeher@gmail.com>

Author: diofeher

github/data_source_github_actions_organization_remove_token.go

@@ -8,6 +8,9 @@ import (
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 )
 
+// dataSourceGithubActionsOrganizationRemoveToken is a data source that creates a token that can be
+// used to remove a self-hosted runner from an organization.
+// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-remove-token-for-an-organization
 func dataSourceGithubActionsOrganizationRemoveToken() *schema.Resource {
 	return &schema.Resource{
 		Read: dataSourceGithubActionsOrganizationRemoveTokenRead,
@@ -25,7 +28,7 @@ func dataSourceGithubActionsOrganizationRemoveToken() *schema.Resource {
 	}
 }
 
-func dataSourceGithubActionsOrganizationRemoveTokenRead(d *schema.ResourceData, meta interface{}) error {
+func dataSourceGithubActionsOrganizationRemoveTokenRead(d *schema.ResourceData, meta any) error {
 	client := meta.(*Owner).v3client
 	owner := meta.(*Owner).name
 

github/data_source_github_actions_remove_token.go

@@ -8,6 +8,9 @@ import (
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 )
 
+// dataSourceGithubActionsRemoveToken is a data source that creates a token that can be
+// used to remove a self-hosted runner from a repository.
+// https://docs.github.com/en/enterprise-cloud@latest/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-remove-token-for-a-repository
 func dataSourceGithubActionsRemoveToken() *schema.Resource {
 	return &schema.Resource{
 		Read: dataSourceGithubActionsRemoveTokenRead,
@@ -30,15 +33,15 @@ func dataSourceGithubActionsRemoveToken() *schema.Resource {
 	}
 }
 
-func dataSourceGithubActionsRemoveTokenRead(d *schema.ResourceData, meta interface{}) error {
+func dataSourceGithubActionsRemoveTokenRead(d *schema.ResourceData, meta any) error {
 	client := meta.(*Owner).v3client
 	owner := meta.(*Owner).name
 	repoName := d.Get("repository").(string)
 
 	log.Printf("[DEBUG] Creating a GitHub Actions repository remove token for %s/%s", owner, repoName)
 	token, _, err := client.Actions.CreateRemoveToken(context.TODO(), owner, repoName)
 	if err != nil {
-		return fmt.Errorf("error creating a GitHub Actions repository remove token for %s/%s: %s", owner, repoName, err)
+		return fmt.Errorf("error creating a GitHub Actions repository remove token for %s/%s: %w", owner, repoName, err)
 	}
 
 	d.SetId(fmt.Sprintf("%s/%s", owner, repoName))

github/resource_github_team.go

@@ -328,14 +328,15 @@ func resourceGithubTeamDelete(d *schema.ResourceData, meta any) error {
 	ctx := context.WithValue(context.Background(), ctxId, d.Id())
 
 	_, err = client.Teams.DeleteTeamByID(ctx, orgId, id)
-	/*
-		When deleting a team and it failed, we need to check if it has already been deleted meanwhile.
-		This could be the case when deleting nested teams via Terraform by looping through a module
-		or resource and the parent team might have been deleted already. If the parent team had
-		been deleted already (via parallel runs), the child team is also already gone (deleted by
-		GitHub automatically).
-		So we're checking if it still exists and if not, simply remove it from TF state.
-	*/ if err != nil {
+	// When deleting a team and it failed, we need to check if it has already been deleted meanwhile.
+	// This could be the case when deleting nested teams via Terraform by looping through a module
+	// or resource and the parent team might have been deleted already. If the parent team had
+	// been deleted already (via parallel runs), the child team is also already gone (deleted by
+	// GitHub automatically).
+	// So we're checking if it still exists and if not, simply remove it from TF state.
+	//
+	// https://docs.github.com/en/enterprise-cloud@latest/rest/teams/teams?apiVersion=2022-11-28#delete-a-team
+	if err != nil {
 		// Fetch the team in order to see if it exists or not (http 404)
 		_, _, err = client.Teams.GetTeamByID(ctx, orgId, id)
 		if err != nil {