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 exhibits a Windows bias by specifying a Windows PC and Windows Administrator account as prerequisites, listing PowerShell as a required tool, and referencing Windows-specific technologies (e.g., WinRM, Windows Server Failover Clustering). There are no Linux equivalents or alternatives mentioned for these requirements, and no Linux-specific instructions or examples are provided. The documentation assumes a Windows environment throughout, even though Azure CLI and kubectl are cross-platform tools.
Recommendations:
- Update the prerequisites to include support for Linux and macOS platforms, clarifying that Azure CLI and kubectl are cross-platform.
- Provide Linux (and optionally macOS) equivalents for all steps, including installation instructions for required tools (Azure CLI, kubectl, PowerShell) on those platforms.
- Where PowerShell is required, clarify if PowerShell Core (pwsh) is supported on Linux/macOS, and provide usage examples.
- For steps referencing Windows-specific technologies (e.g., WinRM, Windows Server Failover Clustering), explain if/how these steps can be performed from Linux/macOS, or provide alternative approaches.
- Avoid language that assumes the user is on Windows (e.g., 'A Windows PC with internet access'), and instead use inclusive phrasing such as 'A computer with internet access (Windows, Linux, or macOS)'.
- Add explicit notes or callouts wherever a step is only supported or tested on Windows, and provide a roadmap or workaround for users on other platforms.
Create pull request