Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page demonstrates a moderate Windows bias, primarily through the prominence and detail of PowerShell instructions and references to Windows-specific installation guides. PowerShell is given its own dedicated section, while Linux/macOS equivalents (such as Bash scripting) are not mentioned. Installation links for PowerShell and CLI tools often point to Windows-specific pages first. ARM template export instructions list Azure PowerShell before Azure CLI, and the PowerShell section is more detailed than the CLI section.
Recommendations
- Add explicit examples and guidance for Linux/macOS users, such as Bash or shell scripting alternatives to PowerShell.
- Ensure installation instructions for CLI tools (Terraform, Azure CLI, Bicep) include Linux/macOS steps and links, not just Windows.
- Balance the prominence of PowerShell and CLI sections, providing equal detail and examples for both.
- In ARM template export instructions, list Azure CLI before PowerShell or present both equally.
- Where possible, use cross-platform commands (Azure CLI, Terraform) as primary examples, with PowerShell as an alternative.
Create Pull Request