Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment, resource review, and cleanup. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and is presented in parallel tabs throughout. There are no Linux-specific instructions, nor is there mention of Linux shell patterns or tools. The use of PowerShell may implicitly favor Windows users, as it is less commonly used on Linux. The documentation does not explicitly state platform requirements or differences, and does not mention Linux or macOS environments.
Recommendations
- Explicitly state that Azure CLI commands work cross-platform (Windows, Linux, macOS), while PowerShell is most common on Windows.
- Add a note clarifying that PowerShell examples are primarily for Windows users, and that Linux/macOS users should use Azure CLI.
- Consider listing Azure CLI examples first, as it is the most cross-platform tool.
- Include brief instructions or links for installing Azure CLI on Linux/macOS.
- Mention that PowerShell Core is available on Linux/macOS, but is less commonly used for Azure tasks on those platforms.
- Add troubleshooting tips for Linux/macOS users if any steps differ.
Create Pull Request