Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for most steps, but the PowerShell examples are given equal prominence to CLI, and some shell commands (e.g., kubectl get pods -A) are shown in PowerShell syntax. There is no explicit mention or example of Linux/macOS shell environments (e.g., Bash), nor are Linux-specific patterns (such as environment variable export or file redirection) demonstrated. The use of PowerShell variable assignment and command substitution may be unfamiliar or incompatible with Linux users, and the lack of Bash examples may hinder parity.
Recommendations
- Add explicit Bash/Linux/macOS shell examples alongside Azure CLI and PowerShell, especially for environment variable assignment and command substitution.
- When showing kubectl commands, use generic shell syntax (e.g., $TOKEN in Bash) or provide both Bash and PowerShell variants.
- Clarify that Azure CLI commands work cross-platform and provide guidance for Linux/macOS users where file paths, environment variables, or shell behavior differ.
- Avoid using PowerShell-specific syntax (e.g., $TOKEN = ...) as the only example for steps that are likely to be performed on Linux/macOS.
- Consider using tabs for 'Bash' and 'PowerShell' where shell commands are shown, to ensure parity and clarity for all users.
Create Pull Request