Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell instructions, but PowerShell examples are given equal prominence and detail, and specific Windows tools (PowerShell, Git Credential Manager) are referenced. There are several places where Windows-centric terminology and tools are mentioned, and Linux/macOS equivalents (such as terminal types or credential managers) are not discussed. Some troubleshooting steps reference Windows-specific errors (e.g., native module binary distribution for Windows), and PowerShell is presented as a primary method for deployment, which may create friction for Linux/macOS users.
Recommendations
- Add explicit instructions and examples for Linux/macOS users, such as using Bash or zsh terminals.
- Mention Linux/macOS credential managers or clarify that Git Credential Manager is cross-platform, or suggest alternatives.
- When discussing errors, include Linux/macOS-specific troubleshooting notes (e.g., native module build issues on Linux).
- Ensure that CLI examples are shown first or equally with PowerShell, and clarify which commands are platform-agnostic.
- Avoid assuming PowerShell is available or preferred; note that it is Windows-specific and suggest Bash/zsh for Linux/macOS.
- Where screenshots or UI references are given, clarify any platform differences.
Create Pull Request