Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides example commands for Azure CLI, PowerShell, and REST API. However, the PowerShell section is given equal prominence to CLI, despite PowerShell being primarily a Windows tool. The PowerShell examples are extensive and detailed, while there are no equivalent examples for Linux-native scripting (e.g., Bash). Additionally, PowerShell is listed before REST API, and there is no mention of Linux/macOS-specific considerations or alternative tools. The CLI examples are cross-platform, but the presence and depth of PowerShell examples indicate a moderate Windows bias.
Recommendations
- Clarify that Azure CLI examples work on Linux, macOS, and Windows.
- Add Bash shell scripting examples for Linux/macOS users, especially for more complex update scenarios.
- Consider moving PowerShell examples after CLI and REST API, or grouping them in a 'Windows-specific' section.
- Explicitly mention platform compatibility for each example (e.g., 'Works on Linux/macOS/Windows').
- Provide troubleshooting tips for Linux/macOS users if there are known differences.
Create Pull Request