Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by providing only PowerShell examples for command-line operations, using Windows-centric tools and syntax (e.g., PowerShell variables, code blocks), and omitting equivalent Linux shell/bash examples. The instructions and code samples assume a Windows environment, even for cross-platform tools like Azure CLI and kubectl, and do not mention or show how to perform these tasks on Linux or macOS systems.
Recommendations
- Add Linux/bash shell examples alongside PowerShell for all command-line instructions, using appropriate syntax and environment variables.
- Clarify that Azure CLI and kubectl are cross-platform tools and provide guidance for their installation and usage on Linux/macOS.
- Avoid using PowerShell-specific syntax (e.g., $variable) in generic instructions; use environment-agnostic notation or provide both PowerShell and bash equivalents.
- Explicitly mention platform differences where relevant, and ensure parity in step-by-step instructions for Linux and macOS users.
- Consider adding tabs or sections for 'Linux/macOS (bash)' and 'Windows (PowerShell)' to improve accessibility for all users.
Create Pull Request