Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides detailed PowerShell examples for resizing Azure VMs, including scripts for both standalone VMs and those in availability sets. PowerShell is a Windows-centric tool, and its examples are more extensive and appear before Azure CLI and Terraform. The Terraform section references Windows VM quickstart code, and the CLI examples use Bash, but PowerShell is presented as the primary scripting method. There is no explicit Linux example (e.g., Bash or shell script) for resizing VMs outside of Azure CLI, and Windows tools/patterns are mentioned first and more thoroughly.
Recommendations
- Add parity between PowerShell and Azure CLI examples by providing equally detailed Bash/shell scripts for Linux/macOS users.
- In the Terraform section, reference both Windows and Linux VM quickstart code, not just Windows.
- Reorder sections so that Azure CLI (cross-platform) is presented before PowerShell.
- Explicitly mention that Azure CLI works on Linux/macOS and provide guidance for those environments.
- Where PowerShell is used, clarify that it is available on Linux/macOS, but provide Bash alternatives for common tasks.
Create Pull Request