Document Details
Elastic San Troubleshoot
❌
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
Bias Types:
⚠️
windows_first
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias in several sections. Windows tools and scripts (e.g., iscsicli, mpclaim, PowerShell scripts) are often mentioned before or more prominently than their Linux equivalents. Some troubleshooting steps and examples are provided only for Windows, or with more detail for Windows than Linux. In some cases, Linux commands are mentioned, but not always with the same level of explanation or parity.
Recommendations:
- Ensure that Linux commands and tools are presented alongside Windows equivalents, and with equal prominence and detail.
- Where PowerShell scripts are referenced for Windows, provide Bash or Python script equivalents for Linux, and link to them with equal visibility.
- Avoid listing Windows tools or commands first by default; alternate the order or present both together.
- Where session limits or configuration parameters are discussed, provide explicit Linux instructions and examples, not just for Windows.
- In sections like 'Unable to connect to more than eight volumes to a Windows VM', add a parallel section for Linux VMs if applicable, or clarify if the limitation is Windows-specific.
- In the 'Troubleshoot CRC protection' section, provide step-by-step Linux instructions with the same clarity as the Windows instructions.
- Review all troubleshooting steps to ensure Linux users are not required to infer steps from Windows-centric instructions.
Create pull request