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 placement properties), but does not mention or provide equivalent examples for Linux/macOS users (e.g., Azure CLI, Bash). PowerShell is a Windows-centric tool, and its use is assumed throughout, creating friction for users on other platforms. Additionally, PowerShell instructions are given before any mention of cross-platform alternatives, and no Linux/macOS-specific tooling or guidance is offered.
Recommendations
- Add Azure CLI examples for all command-line operations (add, remove, scale, configure placement properties, etc.), as Azure CLI is cross-platform and widely used on Linux/macOS.
- Explicitly state that PowerShell examples are for Windows, and provide Bash/Azure CLI equivalents for Linux/macOS users.
- Where possible, mention cross-platform tools first or alongside PowerShell, to avoid implying Windows is the default or only supported platform.
- Include notes or links to installation guides for Azure CLI on Linux/macOS.
- Review all sections for other Windows-specific assumptions (e.g., drive letter conventions) and clarify their applicability to Linux-based clusters.
Create Pull Request