Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell is featured prominently as a primary automation method, and instructions for using the Azure CLI reference Windows PowerShell as the example console application. In several places, Windows tools and terminology (e.g., PowerShell, Windows PowerShell) are mentioned before or instead of Linux/macOS equivalents. However, Azure CLI and template methods are also provided, which are cross-platform, and most steps can be completed on Linux/macOS with minor adjustments.
Recommendations
- When referencing command consoles for Azure CLI, mention cross-platform options such as Bash, zsh, or Terminal on macOS and Linux, not just Windows PowerShell.
- Provide explicit examples or notes for running CLI commands on Linux/macOS, including any differences in syntax or prerequisites.
- Balance PowerShell and CLI coverage by ensuring CLI examples are as detailed and prominent as PowerShell examples.
- Avoid language that implies PowerShell is the default or preferred method for automation; clarify that both CLI and PowerShell are supported on all platforms.
- Where PowerShell modules are discussed, note their availability and usage on Linux/macOS (e.g., via PowerShell Core).
Create Pull Request