Document Details
Requirements
This page contains Windows bias
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
Detected Bias Types
windows_first
windows_tools
windows_example_priority
Summary
The documentation page demonstrates a mild Windows bias. In the NFS setup section, the Windows Server guide is listed before the Linux guide, and the Windows Server link is an official Microsoft documentation page, while the Linux link is to a third-party site. The 'Windows machine (optional)' section emphasizes using a Windows machine for management, with no equivalent mention of Linux management hosts or instructions. The hardware requirements section references AKS on Windows Server, and there is a general tendency to mention Windows-related tools and patterns before their Linux equivalents.
Recommendations
- Provide Linux management host instructions alongside Windows, including tool installation (Azure CLI, kubectl, Helm) for Linux.
- List Linux NFS setup guides before or alongside Windows Server guides, preferably linking to official Linux documentation (e.g., kernel.org, distribution-specific docs).
- Ensure hardware requirements and resource links reference both Windows and Linux environments equally, or clarify when Windows-specific information is relevant.
- Where Windows is mentioned as 'optional', clarify that Linux is equally supported and provide parity in setup steps.
- Review all examples and instructions to ensure Linux users are not disadvantaged or required to infer steps from Windows-centric guidance.
Create Pull Request