Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates Windows bias by referencing Azure PowerShell and Azure CLI as the primary credential sources, listing Azure PowerShell before other options, and omitting explicit Linux/macOS usage patterns or examples. No Linux-specific shell (e.g., Bash) or cross-platform authentication guidance is provided, and no mention is made of Linux package managers or environment setup. The credential precedence lists Azure PowerShell (a Windows-centric tool) before other options, and all examples and instructions assume familiarity with Windows tools.
Recommendations
- Add explicit examples and instructions for Linux/macOS users, such as using Bash or zsh for authentication and module management.
- Clarify that Azure CLI is cross-platform and provide usage examples for both Windows (PowerShell) and Linux/macOS (Bash).
- Include guidance on installing and configuring Bicep and Azure CLI on Linux, referencing package managers like apt, yum, or Homebrew.
- Reorder credential precedence to list cross-platform tools (Azure CLI, Environment) before Windows-specific tools (Azure PowerShell).
- Mention that Azure PowerShell is primarily for Windows and suggest alternatives for Linux/macOS users.
- Provide troubleshooting tips for authentication issues on Linux/macOS environments.
Create Pull Request