About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several areas: Windows and PowerShell tools (such as Chocolatey and Set-ExecutionPolicy) are used for installing Kubernetes CLI tools (kubectl, Helm), and the only explicit file share setup instructions are for Windows. PowerShell scripts and commands are referenced and provided, while Linux equivalents (such as apt, yum, or shell scripts) are missing or not given equal prominence. The documentation references Windows Server and PowerShell walkthroughs before or instead of Linux alternatives, and the use of Windows-centric tools like Chocolatey is not balanced with Linux-native package manager instructions.
Recommendations:
- Provide Linux-native installation instructions for kubectl and Helm (e.g., using apt, yum, or curl/bash scripts) alongside or before Windows/Chocolatey examples.
- Include explicit Linux file share setup instructions (e.g., using Samba or NFS) in addition to the Windows SMB setup steps.
- Offer Linux shell script equivalents for PowerShell commands and scripts, especially for environment setup and automation.
- Reference Linux-based Kubernetes cluster setup guides (e.g., Ubuntu, CentOS) with equal prominence as Windows Server guides.
- Avoid assuming Chocolatey or PowerShell as the default tooling; present cross-platform alternatives or clarify OS-specific instructions.
- Ensure that all code snippets and setup steps are clearly marked for their target OS, and provide parity in detail and support for both Windows and Linux environments.
Create pull request
Flagged Code Snippets
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
choco install kubernetes-cli -y
choco install kubernetes-helm
LOG_ANALYTICS_WORKSPACE_ID=$(az monitor log-analytics workspace show \
--resource-group $GROUP_NAME \
--workspace-name $WORKSPACE_NAME \
--query customerId \
--output tsv)
LOG_ANALYTICS_WORKSPACE_ID_ENC=[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($LOG_ANALYTICS_WORKSPACE_ID))
LOG_ANALYTICS_KEY=$(az monitor log-analytics workspace get-shared-keys \
--resource-group $GROUP_NAME \
--workspace-name $WORKSPACE_NAME \
--query primarySharedKey \
--output tsv)
LOG_ANALYTICS_KEY_ENC=[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($LOG_ANALYTICS_KEY))