Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides step-by-step instructions for Azure portal, PowerShell, and Azure CLI. PowerShell examples are given equal prominence to CLI, but PowerShell is a Windows-centric tool and is listed before CLI in all code sections. There are no Linux-specific shell examples (e.g., Bash scripts outside of Azure CLI), and no mention of Linux tools or patterns. The documentation assumes familiarity with PowerShell and presents it as a primary automation method, which may disadvantage Linux users who prefer Bash or other shells.
Recommendations
- List Azure CLI examples before PowerShell examples to reflect cross-platform parity and reduce Windows-first bias.
- Explicitly mention that Azure CLI commands work natively on Linux, macOS, and Windows, while PowerShell is primarily Windows-centric (unless using PowerShell Core).
- Add Bash script examples for common tasks, such as looping over containers or endpoints, to demonstrate Linux-native automation.
- Include notes or links for Linux users on installing and using Azure CLI, and clarify any platform-specific differences.
- Consider adding troubleshooting steps or validation commands using Bash or other Linux tools where appropriate.
Create Pull Request