Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents both Azure CLI and Azure PowerShell examples for all major workflows. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and in some sections, PowerShell is mentioned before Linux-native patterns. There are no explicit Linux shell script examples, nor any references to Linux-specific tools or package managers. Environment variable examples for proxy configuration are shown for both CLI (Linux-style) and PowerShell (Windows-style), but there is no mention of Linux-specific nuances (such as systemd proxy configuration, bash scripting, or troubleshooting on Linux). The documentation does not reference Linux package managers or provide troubleshooting steps for Linux environments.
Recommendations
- Add explicit Linux shell script examples for key workflows (e.g., using bash, curl, or kubectl in Linux environments).
- Include troubleshooting steps or notes for common Linux proxy configuration issues (such as systemd, environment variables in bash, etc.).
- Reference Linux package managers (e.g., apt, yum) for installing Azure CLI, and clarify prerequisites for Linux environments.
- Consider reordering examples to present Azure CLI (cross-platform, Linux-native) before PowerShell, or clearly indicate CLI as the recommended/default for Linux.
- Add notes on file permissions, SELinux/AppArmor, or other Linux-specific security considerations when onboarding clusters.
Create Pull Request