Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides migration instructions using Azure CLI and PowerShell, but refers to 'PowerShell' generically without clarifying platform differences, and does not mention Linux/macOS specifics or alternatives. The examples and environment variable syntax are platform-neutral, but the narrative prioritizes Windows tools (PowerShell) and does not address Linux shell usage or potential differences in command execution. No Linux/macOS-specific caveats, troubleshooting, or screenshots are provided, and Windows terminology (PowerShell) appears before CLI or Bash equivalents.
Recommendations
- Explicitly mention that Azure CLI commands work on Linux/macOS and provide example shell syntax (e.g., Bash) alongside PowerShell.
- Clarify any platform-specific differences in environment variable setting (e.g., $var for PowerShell, export VAR=... for Bash).
- Include Linux/macOS screenshots or notes where UI or workflow may differ.
- Avoid using 'PowerShell' as a generic term for CLI usage; specify when instructions are for PowerShell vs. Bash.
- Add troubleshooting notes for Linux/macOS users, such as authentication or permission issues that may differ from Windows.
Create Pull Request