Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples exclusively using Azure CLI and Azure PowerShell, which are cross-platform but the PowerShell examples are Windows-centric and shown alongside CLI. There are no Linux/macOS-specific shell examples (e.g., Bash), nor are Linux-native tools or workflows (such as Bash scripting, environment variables, or package managers) mentioned. The structure presents Azure CLI first, but PowerShell is given equal prominence, and some PowerShell examples use Windows-specific patterns (e.g., `$myAKSCluster = Get-AzAksCluster ...`). There are no examples or guidance for Linux users beyond Azure CLI, and no mention of Linux-specific troubleshooting, file paths, or shell environments.
Recommendations
- Add Bash shell examples for all key operations, showing how Linux/macOS users can perform the same tasks.
- Explicitly mention that Azure CLI is cross-platform and provide installation instructions for Linux/macOS.
- Include notes or sections on Linux/macOS-specific considerations (e.g., SSH key generation, file paths, environment variables).
- Avoid using only PowerShell scripting for advanced operations; provide Bash or Python alternatives where possible.
- Clarify that PowerShell can be used on Linux/macOS, but offer native shell alternatives for users who prefer them.
Create Pull Request