Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation is heavily focused on Azure PowerShell, with all command-line examples using PowerShell cmdlets and patterns. There are no Bash, Azure CLI, or Linux/macOS-specific instructions for deploying AKS, managing resources, or connecting to the cluster. The guidance assumes use of PowerShell (locally or in Cloud Shell), and references to installing tools or running commands are PowerShell-centric. This creates friction for Linux/macOS users who typically use Bash and Azure CLI.
Recommendations
- Add equivalent Azure CLI (az) examples for all resource management and AKS deployment steps.
- Provide Bash shell instructions alongside PowerShell, especially for local environments.
- Clarify that Azure Cloud Shell supports both Bash and PowerShell, and show how to select Bash.
- Include links to Azure CLI documentation and installation guides for Linux/macOS users.
- Present examples for both platforms side-by-side or alternate which is shown first.
Create Pull Request