Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
While the documentation is focused on Linux VMs and provides extensive Azure CLI examples (which are cross-platform), the PowerShell section is much longer, more detailed, and introduces Windows-centric tools and terminology (e.g., New-AzStorageBlobSASToken, PowerShell script examples, references to Windows VM behaviors). Some examples and notes reference Windows-specific patterns before Linux equivalents, and certain explanations (such as parameter passing) discuss Windows first. REST and ARM template examples sometimes use PowerShell scripts (.ps1) as the default, even in Linux contexts.
Recommendations
- Balance the depth of Azure CLI and PowerShell sections, ensuring Linux users have equally detailed CLI examples for all advanced scenarios (e.g., output streaming, parameter passing, long-running scripts).
- Replace or supplement PowerShell-specific notes and examples with Bash or shell script equivalents, especially in REST and ARM template sections.
- When discussing parameter passing, present Linux patterns first or side-by-side with Windows patterns.
- Avoid referencing Windows-only tools (e.g., New-AzStorageBlobSASToken) without Linux alternatives or CLI equivalents.
- Ensure all examples referencing scripts use .sh files for Linux contexts, not .ps1.
- Add explicit Bash/shell script examples for advanced scenarios currently only shown in PowerShell.
Create Pull Request