Document Details
Planning Guide Storage
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
powershell_heavy
missing_linux_example
Summary
The documentation generally maintains OS neutrality, but there are several subtle Windows biases. Windows terminology (VHD, SMB) is used throughout, and Windows scenarios/examples are often mentioned before Linux equivalents. Some sections, such as high availability guides, list Windows before Linux, and SMB (Windows) is described before NFS (Linux). There are references to Windows-specific tools (e.g., Storage Spaces) and features, with Linux alternatives mentioned only later or in passing. No explicit PowerShell examples are present, but Windows-centric patterns and terminology dominate. Linux-specific configuration examples, commands, or best practices are largely missing, and Linux tools (e.g., LVM) are referenced only briefly.
Recommendations
- Ensure that Linux/NFS scenarios are described with equal prominence and detail as Windows/SMB scenarios.
- Present Linux and Windows examples side-by-side, or alternate which OS is mentioned first in tables and lists.
- Include Linux-specific configuration guidance and examples (e.g., LVM setup, NFS mount options, striping with mdadm).
- Reference Linux documentation and tools with the same frequency and depth as Windows equivalents.
- Avoid using Windows terminology (e.g., VHD, SMB) as the default; clarify when terms are OS-specific.
- Add explicit Linux command-line examples for storage configuration, mounting, and performance tuning.
Create Pull Request
Clean