Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several ways: PowerShell is frequently used for scripting and verification examples, often presented before or alongside Azure CLI but with more detailed PowerShell workflows; examples of VM extensions and scripts focus on Windows (e.g., configure-music-app.ps1, CustomScriptExtension for Windows); references to Windows-specific tools and patterns (such as Visual Studio and PowerShell DSC) are prevalent; and there is a lack of Linux-specific examples for VM images, extensions, and scripting, with no mention of Bash scripts or Linux VM extension usage.
Recommendations
- Provide Linux-focused examples alongside Windows ones, such as using Bash scripts for VM extensions and referencing Linux VM images (e.g., Ubuntu, CentOS) in ARM templates.
- Balance scripting examples by including Bash/Azure CLI workflows wherever PowerShell is shown, especially for verification and resource queries.
- Mention and demonstrate Linux-compatible development tools (e.g., VS Code on Linux, cross-platform editors) in the testing and automation section.
- Show examples of deploying and configuring Linux VM extensions (e.g., CustomScriptExtension with .sh files, OMI/OMS agents) and how to retrieve their available versions.
- Reference Linux-specific documentation links and best practices where relevant, ensuring parity in guidance for both Windows and Linux environments.
Create Pull Request