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.