Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all operations, as well as Azure portal instructions. However, the PowerShell examples are given equal prominence to CLI, and PowerShell is a Windows-centric tool. There are no Linux-specific shell examples (e.g., Bash scripts, environment variable usage, or platform caveats). The CLI examples are generic and do not address Linux-specific usage patterns, and PowerShell is presented as a first-class option, which may imply a Windows bias. No explicit Windows-only tools are mentioned, but the lack of Linux/Bash-specific guidance is notable.
Recommendations
- Add explicit notes clarifying that Azure CLI works cross-platform and provide examples of running CLI commands in Bash (with environment variables, quoting, and line continuation suited for Linux).
- Mention that PowerShell Core is available on Linux/macOS, or clarify if examples require Windows PowerShell.
- Include troubleshooting or usage notes for Linux users (e.g., differences in shell quoting, authentication, or file paths).
- Consider adding Bash script snippets for common workflows to improve Linux parity.
- Where PowerShell is mentioned, clarify platform compatibility and provide links to PowerShell Core installation for Linux/macOS.
Create Pull Request