Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for Azure CLI, REST API, Azure PowerShell, Visual Studio Code extension, and GitHub Actions. However, Azure PowerShell examples are given equal or greater prominence than Azure CLI, and PowerShell-specific features (like jobs) are described in detail. There is no mention of Linux/macOS-specific shell usage (e.g., Bash), nor are there examples for Bash, zsh, or other common Linux/macOS environments. The documentation assumes familiarity with PowerShell and Windows-centric tooling, and does not clarify cross-platform compatibility for PowerShell commands or provide Linux/macOS-specific guidance.
Recommendations
- Add explicit Bash/zsh examples for command-line operations, especially for REST API calls using curl or similar tools.
- Clarify that Azure CLI is cross-platform and provide usage notes for Linux/macOS users.
- Add a section or note about running Azure PowerShell on Linux/macOS, including installation and usage differences.
- Balance the order of examples, presenting Azure CLI before PowerShell, or interleave them to avoid Windows-first perception.
- Mention and demonstrate use of native Linux/macOS tools (e.g., curl, jq) for REST API interactions.
- Include troubleshooting notes for common Linux/macOS issues (e.g., authentication, environment setup).
Create Pull Request