Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing all command-line examples in PowerShell syntax, referencing Azure PowerShell and Azure CLI usage with PowerShell variables, and omitting equivalent Linux shell (bash) examples. The instructions assume the use of PowerShell, which is native to Windows, and do not mention or demonstrate how to perform the same actions on Linux or macOS systems. Additionally, the use of PowerShell syntax for kubectl commands is atypical for Linux environments.
Recommendations
- Add bash shell examples alongside PowerShell examples for all command-line instructions.
- Explicitly mention that the steps can be performed on Linux/macOS and provide any necessary adjustments (e.g., environment variable syntax differences).
- Use generic CLI syntax (e.g., az, kubectl) without PowerShell-specific variable assignment when possible.
- Clarify that Azure CLI and kubectl are cross-platform tools and provide installation or usage notes for Linux/macOS users.
- Consider reordering examples to present bash/Linux instructions first or in parallel tabs.
Create Pull Request