Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias by exclusively providing Azure PowerShell examples, using PowerShell syntax for all CLI commands (including kubectl), and omitting Linux/macOS shell equivalents. The instructions and code blocks assume a Windows environment, which may cause confusion or friction for Linux/macOS users.
Recommendations
- Provide Bash (Linux/macOS) equivalents for all command-line examples, especially for az and kubectl commands.
- Use generic shell syntax for cross-platform tools like az and kubectl, or clearly separate Windows (PowerShell) and Linux/macOS (Bash) tabs.
- Clarify that az and kubectl commands work on all platforms, and avoid using PowerShell-specific variable syntax unless necessary.
- Add explicit instructions for Linux/macOS users, including installation and usage notes for az and kubectl.
Create Pull Request