Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
Summary
The documentation exhibits a moderate Windows bias. References to enabling managed identities on VMs consistently link to Windows VM instructions, with no mention of Linux VM equivalents. Environment variable examples are provided for both Linux (bash) and Windows (PowerShell), but PowerShell is emphasized in several places, and the Azure PowerShell tool is discussed in detail. The Azure CLI section uses different environment variable values for Linux and Windows, with Windows using 'PSCRED' (PowerShell credential store), which may not be applicable outside Windows. There is no guidance for enabling managed identities on Linux VMs, and Windows tools/patterns (PowerShell, Windows VM links) are mentioned before or instead of Linux equivalents.
Recommendations
- Add links and instructions for enabling managed identities on Linux VMs, not just Windows VMs.
- Ensure that all environment variable examples are provided for both bash (Linux/macOS) and PowerShell (Windows), and clarify any platform-specific differences.
- Review and explain the use of 'PSCRED' for AZCOPY_AUTO_LOGIN_TYPE on Windows, and clarify what should be used on Linux.
- Include Azure CLI usage examples for both platforms, and avoid implying that PowerShell is required for Windows.
- Where screenshots or UI instructions are given, note any differences for Linux VM configuration in the Azure portal.
- Consider a parity checklist to ensure all steps and references are equally covered for Linux and Windows users.
Create Pull Request