Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by exclusively providing Azure PowerShell examples, using Windows-centric scripting syntax, and omitting equivalent Linux/bash examples. The instructions and code blocks are written in PowerShell, and there is no mention of Linux shell commands or cross-platform alternatives. Even the kubectl command is presented in a PowerShell code block, which may confuse Linux users. The Azure portal instructions are platform-neutral, but all CLI guidance is Windows-focused.
Recommendations
- Provide bash/Linux shell equivalents for all PowerShell commands, especially for az CLI and kubectl usage.
- Use generic code blocks for cross-platform commands like kubectl, or show both PowerShell and bash syntax side-by-side.
- Explicitly mention that az CLI and kubectl are cross-platform, and clarify any OS-specific steps.
- Add a tabbed section for Linux/macOS users, mirroring the PowerShell tab, with bash commands and environment setup instructions.
- Avoid using PowerShell variable syntax ($var) in examples unless also showing bash alternatives.
Create Pull Request