Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page is focused on Linux VM extensions, but consistently presents both Azure CLI and Azure PowerShell examples side-by-side throughout. In several sections, PowerShell examples are given equal prominence to CLI, despite PowerShell being a Windows-centric tool (even though it is cross-platform, its usage is far more common on Windows). Additionally, in the 'Discover VM extensions' section, the PowerShell example is shown after the CLI example, but both are given full code blocks and explanations. There is no evidence of missing Linux examples or exclusive mention of Windows tools, but the parity between CLI and PowerShell may create a subtle Windows-first impression.
Recommendations
- Consider emphasizing Azure CLI as the primary example for Linux-focused documentation, since CLI is natively available on Linux and macOS, while PowerShell is less commonly used in those environments.
- Where PowerShell is included, clarify its cross-platform availability and typical use cases for Linux users.
- If space or clarity is a concern, offer PowerShell examples in expandable sections or as supplementary material, rather than giving them equal prominence.
- Review the ordering of examples to ensure CLI is presented first in all cases for Linux documentation.
- Add explicit notes or links for Linux users on how to install and use PowerShell if they choose to use it.
Create Pull Request