Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell (a Windows-centric tool) is consistently presented first in command sections and examples, with detailed PowerShell output shown. The installation instructions for Azure PowerShell are more prominent and detailed than those for Azure CLI. Example outputs and explanations use PowerShell syntax and conventions, even when Azure CLI equivalents exist. There is a lack of explicit Linux shell (bash/zsh) context, and no mention of Linux-specific considerations or alternative shells/tools.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first in some sections to balance visibility.
- Provide example outputs in both PowerShell and Azure CLI formats, especially in sections where output is shown.
- Include notes or sections on running Azure CLI in Linux/macOS environments, such as shell differences, color support, and configuration.
- Add explicit bash/zsh shell script examples where programmatic evaluation is discussed, not just PowerShell variables and loops.
- Ensure installation instructions for Azure CLI are as detailed and prominent as those for Azure PowerShell.
- Avoid using Windows-centric terminology (e.g., PowerShell prompt conventions) as the default; clarify when examples are Windows-specific.
- Mention cross-platform compatibility and any platform-specific caveats for both PowerShell and CLI usage.
Create Pull Request