Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell (a Windows-centric tool) is consistently presented before Azure CLI in code example tabs, and PowerShell scripts are shown in full detail. The use of PowerShell as a primary automation example can be intimidating or less relevant for Linux users, even though Azure CLI is cross-platform. References to converting unmanaged disks mention both CLI and PowerShell, but the PowerShell link is listed second in one place and first in another. There is no explicit Linux shell scripting (bash) example, and the overall structure and language tend to favor Windows tools and patterns.
Recommendations
- Alternate the order of PowerShell and CLI examples so that CLI is presented first in some sections, especially those relevant to Linux users.
- Add explicit bash scripting examples for common disk conversion tasks to improve accessibility for Linux administrators.
- Clarify that Azure CLI is cross-platform and suitable for both Windows and Linux environments.
- Where PowerShell is used, note its availability on Linux and macOS, but also provide native bash alternatives.
- Ensure that references to conversion guides (unmanaged to managed disks) mention Linux/CLI first or equally.
- Consider adding a short section or callout for Linux-specific considerations or best practices.
Create Pull Request