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 node types), but does not offer equivalent examples for Linux/macOS users (e.g., Azure CLI, Bash, or cross-platform scripting). PowerShell is a Windows-centric tool, and its exclusive use creates friction for users on other platforms. Additionally, PowerShell examples are presented before any mention of alternatives, and no Linux/macOS-specific instructions or notes are provided.
Recommendations
- Add Azure CLI examples for all command-line operations alongside PowerShell, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Explicitly mention that PowerShell Core is available for Linux/macOS, if relevant, and provide installation guidance or links.
- Where possible, provide Bash script examples or note how ARM template deployments can be performed using Azure CLI on any OS.
- Structure command-line sections to present cross-platform options first, or in parallel, rather than defaulting to Windows/PowerShell.
- Add a note clarifying platform compatibility for all tools mentioned.
Create Pull Request