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
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation generally strives for parity between Windows and Linux, but there are several instances of Windows bias. Windows tools and patterns (e.g., Storage Spaces, drive D:) are often mentioned before or in more detail than their Linux equivalents. Some examples and links are Windows-specific, and Windows terminology is sometimes used as the default. Linux alternatives are present but sometimes less detailed or referenced after Windows. There are also references to Windows-specific guides and tools without equivalent Linux guidance in some sections.
Recommendations:
- Ensure that Linux examples and tools (e.g., LVM, MDADM) are presented with equal prominence and detail as Windows tools (e.g., Storage Spaces).
- When providing step-by-step guides or links (such as for converting unmanaged to managed disks), ensure Linux and Windows links are presented together and with equal context.
- Avoid using Windows terminology (e.g., 'drive D:') as the default; always provide the Linux equivalent (e.g., '/mnt/resource') in parallel.
- Where Windows-specific tools or procedures are described (such as Storage Spaces), provide equally detailed Linux procedures and best practices.
- Review all sections for implicit Windows-first ordering and alternate with Linux-first or neutral ordering.
- Include Linux-specific troubleshooting and operational guidance where Windows-specific guidance is given.
Create pull request