Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation demonstrates a moderate Windows bias by providing extensive, detailed PowerShell instructions (including module installation, troubleshooting, and advanced usage) before Azure CLI examples. PowerShell, a Windows-centric tool, is given more prominence and depth than the cross-platform Azure CLI. There are no Linux-specific shell (bash) examples, and all command-line guidance assumes PowerShell or Azure CLI, with PowerShell presented first and in greater detail.
Recommendations
- Provide bash (Linux/macOS) shell examples alongside PowerShell for all command-line instructions, especially for Azure CLI usage.
- Reorder sections to present Azure CLI examples before or alongside PowerShell, as Azure CLI is cross-platform and more commonly used on Linux.
- Explicitly mention that Azure CLI commands can be run on Linux, macOS, and Windows, and provide any OS-specific installation or troubleshooting notes.
- Where PowerShell-specific troubleshooting or module management is discussed, offer equivalent guidance for bash or zsh users (e.g., virtual environments, PATH issues).
- Avoid assuming PowerShell as the default shell for command-line instructions; clarify which shell is being used and offer parity for Linux users.
Create Pull Request