Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently provides PowerShell examples for command-line operations (add, remove, scale, configure properties), but does not mention or provide equivalent examples for Linux/macOS users (e.g., Azure CLI, Bash, or cross-platform scripting). PowerShell is Windows-centric, and its use is assumed throughout, creating friction for users on other platforms. Additionally, Windows tools and patterns (e.g., drive letters, PowerShell cmdlets) are referenced without Linux alternatives or context.
Recommendations
- Add Azure CLI examples for all operations currently shown with PowerShell, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Explicitly mention that PowerShell cmdlets can be run on Linux/macOS (via PowerShell Core), or provide Bash script equivalents where possible.
- Where drive letters or Windows-specific concepts are referenced (e.g., diskLetter), clarify behavior on Linux-based node types or note any differences.
- Ensure that examples and instructions do not assume a Windows environment; include notes or sections for Linux/macOS users where relevant.
- Consider listing Azure CLI examples before or alongside PowerShell to avoid 'windows_first' bias.
Create Pull Request