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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation provides both Linux (K3S/Ubuntu) and Windows (AKS Edge Essentials/Windows 11) setup instructions in parallel tabs. However, there are several signs of Windows bias: PowerShell is used for all variable and Azure CLI command examples (even in the Linux/K3S section), Windows-specific tools and commands (like netsh portproxy) are described in detail, and some steps (like port mapping) are only documented for Windows with no Linux equivalent or guidance. Additionally, PowerShell syntax is used for environment variables and Azure CLI commands in the Linux section, which is not idiomatic for Linux users.
Recommendations:
- Provide Bash shell examples for all Azure CLI and environment variable commands in the K3S/Linux sections, using standard Linux syntax (e.g., export VAR=value).
- Document the equivalent port mapping steps for Linux hosts (e.g., using iptables or firewalld) when exposing Kubernetes LoadBalancer services, not just for Windows/netsh.
- Ensure that Linux tools and patterns are described with equal detail and priority as Windows tools (e.g., explain how to check service accessibility and configure networking on Linux).
- Avoid using PowerShell syntax in Linux sections; use Bash or sh syntax instead.
- If a step is only required for Windows, explicitly state the Linux equivalent is not needed or provide alternative instructions.
- Review all code blocks and outputs to ensure they are platform-appropriate for the section they appear in.
Create pull request