Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page is heavily focused on Azure PowerShell, with all CLI examples provided in PowerShell syntax. There are no equivalent examples using Azure CLI (az), Bash, or Linux-native tools, despite the page stating applicability to Linux VMs. Windows-centric tools and patterns (e.g., PowerShell cmdlets, Windows networking conventions) are used exclusively and referenced first. The linked resources also point to Windows/PowerShell documentation. This creates friction for Linux/macOS users who may not have or use PowerShell.
Recommendations
- Add equivalent Azure CLI (az) and Bash examples for all major steps, including retrieving VM plan info, creating image definitions, and deploying VMs.
- Explicitly mention cross-platform alternatives and clarify which steps can be performed on Linux/macOS.
- Update references and links to include both Windows/PowerShell and Linux/CLI documentation.
- Consider reordering examples so that cross-platform (CLI/Bash) instructions appear before or alongside PowerShell examples.
Create Pull Request