🩹 [Patch]: Update environment functions documentation and remove unused environment class

[MariusStorhaug]

Description

This pull request includes significant changes to the handling of GitHub environments in the PowerShell module. The most important changes involve the removal of the Environment class and its related classes, updates to the example outputs in several functions, and some adjustments to the function signatures.

Removal of Classes:

• src/classes/public/Environment/GitHubEnvironment.ps1: Removed the Environment, RequiredReviewers, BranchPolicy, and DeploymentBranchPolicy classes, which were used to model GitHub environment data.

Updates to Example Outputs:

• src/functions/private/Environments/Get-GitHubEnvironmentByName.ps1: Updated the example output to reflect the new format of environment details, including additional fields like id, node_id, and protection_rules.
• src/functions/private/Environments/Get-GitHubEnvironmentList.ps1: Updated the example output to show the new format for listing environments, including fields like id, node_id, protection_rules, and deployment_branch_policy.
• src/functions/public/Environments/Get-GitHubEnvironment.ps1: Updated the example output to reflect the new format of environment details, similar to the changes made in Get-GitHubEnvironmentByName.

Function Signature Adjustments:

• src/functions/public/Environments/Remove-GitHubEnvironment.ps1: Changed the output type of the Remove-GitHubEnvironment function from PSCustomObject to void, indicating that it no longer returns an object.
• src/functions/public/Environments/Set-GitHubEnvironment.ps1: Modified the example to use a hashtable for parameters, demonstrating a more complex usage scenario with additional fields like Reviewers and DeploymentBranchPolicy.

Type of change

• 📖 [Docs]
• 🪲 [Fix]
• 🩹 [Patch]
• ⚠️ [Security fix]
• 🚀 [Feature]
• 🌟 [Breaking change]

Checklist

• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas

[Copilot]

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

[github-actions]

Module GitHub - 0.16.1 published to the PowerShell Gallery.

[github-actions]

GitHub release for GitHub v0.16.1 has been created.