Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides extensive PowerShell examples alongside Azure CLI and portal instructions. PowerShell is a Windows-centric tool, and its usage is described in detail, including installation and file path examples using Windows-style paths (e.g., C:\temp\json.txt). There is no mention of Linux-specific shell usage (such as Bash) or cross-platform scripting alternatives. PowerShell examples are given equal or greater prominence than CLI, and Windows file system conventions are used in code samples. There are no explicit Linux-only examples or guidance for Linux users.
Recommendations
- Add Bash shell examples for all CLI commands, demonstrating usage on Linux/macOS.
- Use platform-neutral file paths in examples (e.g., /tmp/json.txt or ./policy.json) or provide both Windows and Linux path variants.
- Explicitly mention that Azure CLI works on Linux/macOS and provide installation links for those platforms.
- Include notes or sections for Linux users, such as using az CLI in Bash, handling JSON files, and alternative scripting approaches.
- Avoid assuming PowerShell as the default scripting environment; clarify its cross-platform availability or suggest alternatives.
- Where PowerShell is used for scripting, provide equivalent Bash scripts for Linux users.
Create Pull Request