Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Azure CLI and PowerShell examples, but PowerShell (a Windows-centric tool) is given equal prominence and detailed usage instructions. There is no mention of Linux-specific tools or shell patterns (e.g., Bash), nor is there any explicit guidance for Linux users. The PowerShell examples and references to Connect-AzAccount suggest a Windows bias, as PowerShell is primarily used on Windows, and its usage is highlighted alongside CLI. REST API examples are platform-neutral, but the lack of Linux/Bash-specific instructions or examples is notable.
Recommendations
- Add explicit Bash examples for Linux users, especially for authentication and scripting.
- Clarify that Azure CLI works cross-platform and provide shell-specific instructions (e.g., Bash, zsh).
- Mention that PowerShell Core is available on Linux, or provide links to install/use it on Linux if PowerShell examples are retained.
- Include notes or tabs for Linux/macOS users, highlighting any differences or prerequisites.
- Ensure that CLI examples use syntax and patterns common to Linux shells (e.g., environment variables, piping, jq for JSON parsing).
Create Pull Request