Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page shows a moderate Windows bias. PowerShell (a Windows-centric tool) is presented first and in detail, with extensive scripting examples. Azure CLI examples are provided for both Bash (Linux) and Windows environments, but Windows syntax is listed alongside Bash, and some instructions (like variable setting) default to Windows batch syntax before Bash. There is no explicit Linux shell scripting example beyond Bash variable assignment, and the overall structure and examples favor Windows tools and patterns.
Recommendations
- Alternate the order of PowerShell and Azure CLI sections, or present Azure CLI (cross-platform) first to avoid Windows-first bias.
- Expand Bash/Linux examples to include more idiomatic shell scripting, such as using shell functions or scripts, rather than only variable assignment.
- Provide explicit Linux shell script examples (e.g., .sh files) for starting/stopping VMs, not just Bash commands.
- Clarify that Azure CLI works natively on Linux/macOS and provide installation instructions or links for those platforms.
- Reduce reliance on Windows batch syntax (e.g., 'set' commands) and emphasize Bash/Linux equivalents.
- Include troubleshooting or notes relevant to Linux environments, such as permissions or shell differences.
Create Pull Request