Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Windows/Powershell instructions and scripts before Linux equivalents in the 'Disconnect volumes from clients' section. PowerShell examples are consistently shown first in all deletion operations, with Azure CLI (cross-platform) examples following. While Linux instructions and CLI examples are present, the ordering and emphasis favor Windows and PowerShell, which may create friction for Linux/macOS users.
Recommendations
- Alternate the order of examples, sometimes showing Azure CLI or Linux instructions first.
- Explicitly mention that Azure CLI is cross-platform and suitable for Linux/macOS users.
- Ensure parity in detail and clarity between Windows/Powershell and Linux/CLI instructions.
- Consider adding macOS-specific notes if relevant.
- Use neutral language (e.g., 'On Windows, use PowerShell; on Linux/macOS, use CLI') to avoid implying Windows is the default.
Create Pull Request