Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides examples and instructions for Azure PowerShell, Azure CLI, REST API, and Azure Portal. However, PowerShell examples are consistently present and detailed, and in several sections (especially creation and update flows), PowerShell is listed before CLI. The documentation references PowerShell-specific cmdlets and patterns, which are primarily Windows-centric, and does not mention Linux/macOS-specific shell usage (e.g., bash, zsh) or alternative scripting environments. There are no explicit Linux/macOS shell script examples, nor any mention of OS-specific considerations for CLI usage.
Recommendations
- Add explicit bash/zsh shell script examples for Azure CLI commands, showing usage on Linux/macOS (e.g., environment variable syntax, quoting, file redirection).
- Clarify that Azure CLI commands work cross-platform and provide notes or tips for Linux/macOS users (e.g., installation, authentication differences, file path conventions).
- Balance the order of examples so that CLI and REST API instructions are shown before or alongside PowerShell, not after.
- Where PowerShell is referenced, note that it is available cross-platform, but provide links or instructions for Linux/macOS installation if relevant.
- If there are any OS-specific caveats (e.g., for health extension endpoints, networking, or authentication), call them out explicitly.
Create Pull Request