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
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation exhibits a moderate Windows bias. Windows tools and scripts (e.g., PowerShell, iscsicli, mpclaim) are often mentioned first or exclusively, and some troubleshooting steps provide detailed instructions or scripts for Windows before Linux equivalents. In some sections, Linux examples are present but less detailed or referenced after Windows. There are also cases where only Windows session limits or tools are discussed, and Linux-specific details are less prominent.
Recommendations:
- Ensure that for every Windows tool or script mentioned (e.g., iscsicli, mpclaim, PowerShell scripts), the equivalent Linux command or script (e.g., iscsiadm, multipath, bash/python scripts) is provided with equal detail and prominence.
- Present Linux and Windows instructions in parallel or side-by-side, rather than listing Windows first by default.
- Where session limits or configuration parameters are discussed for Windows, provide the corresponding Linux values and commands.
- Expand Linux troubleshooting steps to match the depth and clarity of Windows steps, including direct command examples and links to scripts.
- Review the order of examples and ensure Linux is not consistently presented after Windows, to avoid reinforcing a Windows-first perspective.
Create pull request